--- canonical_url: "https://docs.composio.dev/toolkits/bland_ai" markdown_url: "https://docs.composio.dev/toolkits/bland_ai.md" product: "platform" version: null last_updated: null --- # Bland AI Bland AI is a conversational AI platform for building, operating, and evaluating voice agents, calls, messaging, and related communications workflows. - **Category:** ai agents - **Auth:** API_KEY - **Composio-managed OAuth available?** N/A - **Tools:** 18 - **Triggers:** 0 - **Slug:** `BLAND_AI` - **Version:** 20261014_01 ## Tools ### 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | Optional version display name. | | `agent_id` | string | Yes | Agent that owns the new version. | | `autosave` | boolean | No | Mark this as an editor background save. Bland may rewrite an eligible unnamed autosave head in place instead of appending a version. | | `snapshot` | object | Yes | Complete provider-native agent configuration snapshot. | | `branch_id` | string | No | Open branch to save onto; omit to use the development timeline. | | `parent_revision` | integer | No | Expected current head revision for compare-and-set; omit to skip. | | `parent_version_id` | string | No | Expected current head version for compare-and-set. Send null to assert that the timeline is empty; omit to skip this check. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | Name for the new pathway folder. | | `parent_folder_id` | string | No | Existing parent folder ID; omit to create the folder at the root. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `folder_id` | string | Yes | ID of the empty pathway folder to delete. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `agent_id` | string | Yes | Unique identifier of the Bland AI agent to retrieve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `knowledge_base_id` | string | Yes | Unique ID of the knowledge base to retrieve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `branch` | string | No | Open branch ID whose newest save to retrieve; omit for the dev timeline. | | `agent_id` | string | Yes | Unique ID of the agent whose newest saved version to retrieve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Pathway **Slug:** `BLAND_AI_GET_PATHWAY` Retrieve one Bland AI conversational pathway by ID, including its name, description, nodes, and edges. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pathway_id` | string | Yes | Unique identifier of the conversational pathway to retrieve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Tool **Slug:** `BLAND_AI_GET_TOOL` Retrieve one legacy Bland AI custom tool by its TL-prefixed ID. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `tool_id` | string | Yes | ID of the custom tool to retrieve; Bland AI tool IDs start with TL-. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. | | `inbound` | boolean | No | Return inbound calls when true or outbound calls when false. | | `sort_by` | string ("created_at" | "updated_at") | No | Timestamp field used to sort calls. | | `batch_id` | string | No | Return calls belonging to this batch ID. | | `end_date` | string | No | Inclusive created-at upper bound as YYYY-MM-DD or an ISO 8601 datetime. | | `timezone` | string | No | IANA timezone used to interpret date-only created-at filters. | | `ascending` | boolean | No | Sort calls from oldest to newest when true. | | `completed` | boolean | No | Filter by whether the call completed. | | `to_number` | string | No | Return calls dispatched to this phone number. | | `created_at` | string | No | Exact created date as YYYY-MM-DD; cannot be combined with start_date or end_date. | | `start_date` | string | No | Inclusive created-at lower bound as YYYY-MM-DD or an ISO 8601 datetime. | | `answered_by` | string | No | Filter by answer classification, such as human. | | `campaign_id` | string | No | Return calls belonging to this campaign ID. | | `duration_gt` | number | No | Return calls longer than this many minutes. | | `duration_lt` | number | No | Return calls shorter than this many minutes. | | `from_number` | string | No | Return calls dispatched from this phone number. | | `update_end_date` | string | No | Inclusive updated-at upper date as YYYY-MM-DD. | | `update_start_date` | string | No | Inclusive updated-at lower date as YYYY-MM-DD. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Contacts **Slug:** `BLAND_AI_LIST_CONTACTS` Return organization contacts and their identifiers and memory records one page at a time. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum contacts to return in this page. | | `cursor` | string | No | Continuation cursor returned by a previous call; omit for the first page. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum knowledge bases to return in this page (1-100). | | `cursor` | string | No | Continuation cursor from a previous call; omit for the first page. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Pathways **Slug:** `BLAND_AI_LIST_PATHWAYS` Return all conversational pathways, including their names, descriptions, nodes, and edges. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Tools **Slug:** `BLAND_AI_LIST_TOOLS` Search and page through the active or draft tools configured for Bland agents. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum tools to return in this page. | | `cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for page one. | | `search` | string | No | Search tool names and descriptions. | | `order_by` | string | No | Field used to order tools; Bland AI currently supports created_at only. | | `order_direction` | string ("asc" | "desc") | No | Sort direction: asc or desc. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `bump` | string ("patch" | "minor" | "major") | No | Semantic-version component to increment when staging mints a version number. | | `agent_id` | string | Yes | Agent to release. | | `snapshot` | object | No | Complete provider-native agent configuration to save as a new version and publish to staging. When supplied, Bland ignores version_id. | | `version_id` | string | No | Existing dev-timeline version to publish to staging; omit to publish the latest saved version. | | `target_environment` | string ("staging" | "production") | Yes | Publish to staging or promote the staging version to production. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Rename Pathway Folder **Slug:** `BLAND_AI_RENAME_PATHWAY_FOLDER` Rename an existing pathway folder without moving or changing any pathways inside it. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | New name for the pathway folder. | | `folder_id` | string | Yes | ID of the pathway folder to rename. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not |