> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Bland AI

> Bland AI is a conversational AI platform for building, operating, and evaluating voice agents, calls, messaging, and related communications workflows.

![Bland AI logo](https://mintcdn.com/composio-preview/6S5R4NszqpnVIZRD/images/toolkits/bland_ai.svg?fit=max\&auto=format\&n=6S5R4NszqpnVIZRD\&q=85\&s=17457b4051c8c53ebc78decc4fc7eece)

* **Category:** ai agents
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 26
* **Triggers:** 0
* **Slug:** `BLAND_AI`
* **Version:** 20261030\_00

## Tools

> [accordion] Add User to Memory
>
> **Slug:** `BLAND_AI_ADD_USER_TO_MEMORY`
>
> Add a phone-number user and optional initial context to an existing Bland memory. Requires a full-access API key; Bland documents no restricted-key permission for memory membership.
>
> #### Input Parameters
>
> **summary** `string`
>
> Initial summary of the user's interactions.
>
> **metadata** `string`
>
> Custom context text to associate with the user.
>
> **memory\_id** `string` *required*
>
> Memory to add the user to.
>
> **phone\_number** `string` *required*
>
> Phone number of the user to add.
>
> **external\_memory\_key** `string`
>
> External key for memory validation or cross-referencing.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Agent Version
>
> **Slug:** `BLAND_AI_CREATE_AGENT_VERSION`
>
> Save a complete agent configuration snapshot on the development timeline or an open branch without deploying it. Autosaves may rewrite the eligible current autosave head in place.
>
> #### Input Parameters
>
> **name** `string`
>
> Optional version display name.
>
> **agent\_id** `string` *required*
>
> Agent that owns the new version.
>
> **autosave** `boolean`
>
> Mark this as an editor background save. Bland may rewrite an eligible unnamed autosave head in place instead of appending a version.
>
> **snapshot** `object` *required*
>
> Complete provider-native agent configuration snapshot.
>
> **branch\_id** `string`
>
> Open branch to save onto; omit to use the development timeline.
>
> **parent\_revision** `integer`
>
> Expected current head revision for compare-and-set; omit to skip.
>
> **parent\_version\_id** `string`
>
> Expected current head version for compare-and-set. Send null to assert that the timeline is empty; omit to skip this check.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Pathway Folder
>
> **Slug:** `BLAND_AI_CREATE_PATHWAY_FOLDER`
>
> Create an empty pathway folder, optionally nested under an existing folder, without running calls or agents.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name for the new pathway folder.
>
> **parent\_folder\_id** `string`
>
> Existing parent folder ID; omit to create the folder at the root.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Pathway Folder
>
> **Slug:** `BLAND_AI_DELETE_PATHWAY_FOLDER`
>
> Delete an empty pathway folder by ID; folders containing pathways or subfolders must be emptied first.
>
> #### Input Parameters
>
> **folder\_id** `string` *required*
>
> ID of the empty pathway folder to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Account Details
>
> **Slug:** `BLAND_AI_GET_ACCOUNT_DETAILS`
>
> Return the connected Bland AI account's status, call count, balance, and refill settings without changing the account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Agent
>
> **Slug:** `BLAND_AI_GET_AGENT`
>
> Retrieve one Bland AI agent by ID, including its development, staging, and production environment version pointers.
>
> #### Input Parameters
>
> **agent\_id** `string` *required*
>
> Unique identifier of the Bland AI agent to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Agent Version
>
> **Slug:** `BLAND_AI_GET_AGENT_VERSION`
>
> Retrieve a specific published agent version by semantic version, including its full configuration snapshot and version metadata.
>
> #### Input Parameters
>
> **semver** `string` *required*
>
> Published semantic version in numeric MAJOR.MINOR.PATCH form, such as 1.2.0.
>
> **agent\_id** `string` *required*
>
> Unique ID of the agent whose published version to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Knowledge Base
>
> **Slug:** `BLAND_AI_GET_KNOWLEDGE_BASE`
>
> Retrieve one Bland AI knowledge base by ID, including its processing status, source details, and file metadata.
>
> #### Input Parameters
>
> **knowledge\_base\_id** `string` *required*
>
> Unique ID of the knowledge base to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Latest Agent Version
>
> **Slug:** `BLAND_AI_GET_LATEST_AGENT_VERSION`
>
> Retrieve the newest saved version and full configuration snapshot for an agent's dev timeline or an open branch.
>
> #### Input Parameters
>
> **branch** `string`
>
> Open branch ID whose newest save to retrieve; omit for the dev timeline.
>
> **agent\_id** `string` *required*
>
> Unique ID of the agent whose newest saved version to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Pathway
>
> **Slug:** `BLAND_AI_GET_PATHWAY`
>
> Retrieve one Bland AI conversational pathway by ID, including its name, description, nodes, and edges.
>
> #### Input Parameters
>
> **pathway\_id** `string` *required*
>
> Unique identifier of the conversational pathway to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Tool
>
> **Slug:** `BLAND_AI_GET_TOOL`
>
> Retrieve one legacy Bland AI custom tool by its TL-prefixed ID.
>
> #### Input Parameters
>
> **tool\_id** `string` *required*
>
> ID of the custom tool to retrieve; Bland AI tool IDs start with TL-.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Calls
>
> **Slug:** `BLAND_AI_LIST_CALLS`
>
> Search the connected account's existing inbound and outbound call history without placing or modifying calls.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a previous call; omit for the first page.
>
> **inbound** `boolean`
>
> Return inbound calls when true or outbound calls when false.
>
> **sort\_by** `string ("created_at" | "updated_at")`
>
> Timestamp field used to sort calls.
>
> **batch\_id** `string`
>
> Return calls belonging to this batch ID.
>
> **end\_date** `string`
>
> Inclusive created-at upper bound as YYYY-MM-DD or an ISO 8601 datetime.
>
> **timezone** `string`
>
> IANA timezone used to interpret date-only created-at filters.
>
> **ascending** `boolean`
>
> Sort calls from oldest to newest when true.
>
> **completed** `boolean`
>
> Filter by whether the call completed.
>
> **to\_number** `string`
>
> Return calls dispatched to this phone number.
>
> **created\_at** `string`
>
> Exact created date as YYYY-MM-DD; cannot be combined with start\_date or end\_date.
>
> **start\_date** `string`
>
> Inclusive created-at lower bound as YYYY-MM-DD or an ISO 8601 datetime.
>
> **answered\_by** `string`
>
> Filter by answer classification, such as human.
>
> **campaign\_id** `string`
>
> Return calls belonging to this campaign ID.
>
> **duration\_gt** `number`
>
> Return calls longer than this many minutes.
>
> **duration\_lt** `number`
>
> Return calls shorter than this many minutes.
>
> **from\_number** `string`
>
> Return calls dispatched from this phone number.
>
> **update\_end\_date** `string`
>
> Inclusive updated-at upper date as YYYY-MM-DD.
>
> **update\_start\_date** `string`
>
> Inclusive updated-at lower date as YYYY-MM-DD.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Contacts
>
> **Slug:** `BLAND_AI_LIST_CONTACTS`
>
> Return organization contacts and their identifiers and memory records one page at a time.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum contacts to return in this page.
>
> **cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Inbound Numbers
>
> **Slug:** `BLAND_AI_LIST_INBOUND_NUMBERS`
>
> List inbound phone numbers configured for the connected Bland AI account, including each number's calling settings.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Knowledge Bases
>
> **Slug:** `BLAND_AI_LIST_KNOWLEDGE_BASES`
>
> Return one page of the connected Bland AI organization's knowledge bases, including processing status, source details, and file metadata.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum knowledge bases to return in this page (1-100).
>
> **cursor** `string`
>
> Continuation cursor from a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Pathway Folders
>
> **Slug:** `BLAND_AI_LIST_PATHWAY_FOLDERS`
>
> Return all pathway folders and their parent relationships from Bland's US regional pathway service.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Pathways
>
> **Slug:** `BLAND_AI_LIST_PATHWAYS`
>
> Return all conversational pathways, including their names, descriptions, nodes, and edges.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Pathway Versions
>
> **Slug:** `BLAND_AI_LIST_PATHWAY_VERSIONS`
>
> List the saved versions of a conversational pathway with their version and revision metadata.
>
> #### Input Parameters
>
> **pathway\_id** `string` *required*
>
> Unique ID of the conversational pathway.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tools
>
> **Slug:** `BLAND_AI_LIST_TOOLS`
>
> Search and page through the active or draft tools configured for Bland agents.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum tools to return in this page.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a previous call; omit for page one.
>
> **search** `string`
>
> Search tool names and descriptions.
>
> **order\_by** `string`
>
> Field used to order tools; Bland AI currently supports created\_at only.
>
> **order\_direction** `string ("asc" | "desc")`
>
> Sort direction: asc or desc.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Voices
>
> **Slug:** `BLAND_AI_LIST_VOICES`
>
> List every Bland voice available to the connected account with identifiers and synthesis attributes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Release Agent Version
>
> **Slug:** `BLAND_AI_RELEASE_AGENT_VERSION`
>
> Publish a new snapshot, an existing saved version, or the latest saved version to staging, or promote the version currently in staging to production.
>
> #### Input Parameters
>
> **bump** `string ("patch" | "minor" | "major")`
>
> Semantic-version component to increment when staging mints a version number.
>
> **agent\_id** `string` *required*
>
> Agent to release.
>
> **snapshot** `object`
>
> Complete provider-native agent configuration to save as a new version and publish to staging. When supplied, Bland ignores version\_id.
>
> **version\_id** `string`
>
> Existing dev-timeline version to publish to staging; omit to publish the latest saved version.
>
> **target\_environment** `string ("staging" | "production")` *required*
>
> Publish to staging or promote the staging version to production.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Rename Pathway Folder
>
> **Slug:** `BLAND_AI_RENAME_PATHWAY_FOLDER`
>
> Rename an existing pathway folder without moving or changing any pathways inside it.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> New name for the pathway folder.
>
> **folder\_id** `string` *required*
>
> ID of the pathway folder to rename.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Resolve Contact
>
> **Slug:** `BLAND_AI_RESOLVE_CONTACT`
>
> Find a Bland contact by phone number, email, or external ID, creating one when no match exists. Requires a full-access API key; Bland documents no restricted-key permission for contacts.
>
> #### Input Parameters
>
> **name** `string`
>
> Name to use if a contact is created or enriched.
>
> **email** `string`
>
> Contact email; at least one identifier is required.
>
> **metadata** `object`
>
> Custom contact metadata.
>
> **persona\_id** `string`
>
> Persona for optional memory scoping.
>
> **external\_id** `string`
>
> Caller-owned external identifier; at least one identifier is required.
>
> **agent\_number** `string`
>
> Agent phone number for optional memory scoping.
>
> **phone\_number** `string`
>
> Contact phone number; at least one identifier is required.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Synthesize Speech
>
> **Slug:** `BLAND_AI_SYNTHESIZE_SPEECH`
>
> Generate Bland speech audio from text with a selected voice and return a downloadable WAV reference. Successful synthesis is billed per character with a minimum charge per request; restricted API keys need voices:generate.
>
> #### Input Parameters
>
> **text** `string` *required*
>
> Text to synthesize, up to 5,000 characters.
>
> **audio** `object`
>
> Audio encoding and sample-rate settings. Output is always WAV.
>
> **voice** `string` *required*
>
> UUID of a BTTS\_V2 or BTTS\_V3 voice returned by List Voices.
>
> **controls** `object`
>
> Optional voice expressiveness and stability controls.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Contact
>
> **Slug:** `BLAND_AI_UPDATE_CONTACT`
>
> Update a Bland contact's name, email, external ID, or custom metadata. Requires a full-access API key; Bland documents no restricted-key permission for contacts.
>
> #### Input Parameters
>
> **name** `string`
>
> Updated contact name.
>
> **email** `string`
>
> Email identifier to add or update.
>
> **metadata** `object`
>
> Custom metadata keys to merge.
>
> **contact\_id** `string` *required*
>
> Contact to update.
>
> **external\_id** `string`
>
> External identifier to add or update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Contact Facts
>
> **Slug:** `BLAND_AI_UPDATE_CONTACT_FACTS`
>
> Merge structured facts into a Bland contact memory without deleting existing keys. Requires a full-access API key; Bland documents no restricted-key permission for contact memory.
>
> #### Input Parameters
>
> **facts** `object` *required*
>
> Structured key-value facts to merge into the contact memory. Existing keys not included here are retained.
>
> **memory\_id** `string` *required*
>
> Contact memory record to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
