Skip to main content
Bland AI logo
  • Category: ai agents
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 26
  • Triggers: 0
  • Slug: BLAND_AI
  • Version: 20261030_00

Tools

Slug: BLAND_AI_ADD_USER_TO_MEMORYAdd 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

string
Initial summary of the user’s interactions.
string
Custom context text to associate with the user.
string
required
Memory to add the user to.
string
required
Phone number of the user to add.
string
External key for memory validation or cross-referencing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_CREATE_AGENT_VERSIONSave 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

string
Optional version display name.
string
required
Agent that owns the new version.
boolean
Mark this as an editor background save. Bland may rewrite an eligible unnamed autosave head in place instead of appending a version.
object
required
Complete provider-native agent configuration snapshot.
string
Open branch to save onto; omit to use the development timeline.
integer
Expected current head revision for compare-and-set; omit to skip.
string
Expected current head version for compare-and-set. Send null to assert that the timeline is empty; omit to skip this check.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_CREATE_PATHWAY_FOLDERCreate an empty pathway folder, optionally nested under an existing folder, without running calls or agents.

Input Parameters

string
required
Name for the new pathway folder.
string
Existing parent folder ID; omit to create the folder at the root.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_DELETE_PATHWAY_FOLDERDelete an empty pathway folder by ID; folders containing pathways or subfolders must be emptied first.

Input Parameters

string
required
ID of the empty pathway folder to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_GET_ACCOUNT_DETAILSReturn the connected Bland AI account’s status, call count, balance, and refill settings without changing the account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_GET_AGENTRetrieve one Bland AI agent by ID, including its development, staging, and production environment version pointers.

Input Parameters

string
required
Unique identifier of the Bland AI agent to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_GET_AGENT_VERSIONRetrieve a specific published agent version by semantic version, including its full configuration snapshot and version metadata.

Input Parameters

string
required
Published semantic version in numeric MAJOR.MINOR.PATCH form, such as 1.2.0.
string
required
Unique ID of the agent whose published version to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_GET_KNOWLEDGE_BASERetrieve one Bland AI knowledge base by ID, including its processing status, source details, and file metadata.

Input Parameters

string
required
Unique ID of the knowledge base to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_GET_LATEST_AGENT_VERSIONRetrieve the newest saved version and full configuration snapshot for an agent’s dev timeline or an open branch.

Input Parameters

string
Open branch ID whose newest save to retrieve; omit for the dev timeline.
string
required
Unique ID of the agent whose newest saved version to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_GET_PATHWAYRetrieve one Bland AI conversational pathway by ID, including its name, description, nodes, and edges.

Input Parameters

string
required
Unique identifier of the conversational pathway to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_GET_TOOLRetrieve one legacy Bland AI custom tool by its TL-prefixed ID.

Input Parameters

string
required
ID of the custom tool to retrieve; Bland AI tool IDs start with TL-.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_LIST_CALLSSearch the connected account’s existing inbound and outbound call history without placing or modifying calls.

Input Parameters

string
Opaque continuation cursor returned by a previous call; omit for the first page.
boolean
Return inbound calls when true or outbound calls when false.
string ("created_at" | "updated_at")
Timestamp field used to sort calls.
string
Return calls belonging to this batch ID.
string
Inclusive created-at upper bound as YYYY-MM-DD or an ISO 8601 datetime.
string
IANA timezone used to interpret date-only created-at filters.
boolean
Sort calls from oldest to newest when true.
boolean
Filter by whether the call completed.
string
Return calls dispatched to this phone number.
string
Exact created date as YYYY-MM-DD; cannot be combined with start_date or end_date.
string
Inclusive created-at lower bound as YYYY-MM-DD or an ISO 8601 datetime.
string
Filter by answer classification, such as human.
string
Return calls belonging to this campaign ID.
number
Return calls longer than this many minutes.
number
Return calls shorter than this many minutes.
string
Return calls dispatched from this phone number.
string
Inclusive updated-at upper date as YYYY-MM-DD.
string
Inclusive updated-at lower date as YYYY-MM-DD.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_LIST_CONTACTSReturn organization contacts and their identifiers and memory records one page at a time.

Input Parameters

integer
Maximum contacts to return in this page.
string
Continuation cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_LIST_INBOUND_NUMBERSList inbound phone numbers configured for the connected Bland AI account, including each number’s calling settings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_LIST_KNOWLEDGE_BASESReturn one page of the connected Bland AI organization’s knowledge bases, including processing status, source details, and file metadata.

Input Parameters

integer
Maximum knowledge bases to return in this page (1-100).
string
Continuation cursor from a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_LIST_PATHWAY_FOLDERSReturn all pathway folders and their parent relationships from Bland’s US regional pathway service.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_LIST_PATHWAYSReturn all conversational pathways, including their names, descriptions, nodes, and edges.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_LIST_PATHWAY_VERSIONSList the saved versions of a conversational pathway with their version and revision metadata.

Input Parameters

string
required
Unique ID of the conversational pathway.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_LIST_TOOLSSearch and page through the active or draft tools configured for Bland agents.

Input Parameters

integer
Maximum tools to return in this page.
string
Opaque continuation cursor returned by a previous call; omit for page one.
Search tool names and descriptions.
string
Field used to order tools; Bland AI currently supports created_at only.
string ("asc" | "desc")
Sort direction: asc or desc.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_LIST_VOICESList every Bland voice available to the connected account with identifiers and synthesis attributes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_RELEASE_AGENT_VERSIONPublish 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

string ("patch" | "minor" | "major")
Semantic-version component to increment when staging mints a version number.
string
required
Agent to release.
object
Complete provider-native agent configuration to save as a new version and publish to staging. When supplied, Bland ignores version_id.
string
Existing dev-timeline version to publish to staging; omit to publish the latest saved version.
string ("staging" | "production")
required
Publish to staging or promote the staging version to production.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_RENAME_PATHWAY_FOLDERRename an existing pathway folder without moving or changing any pathways inside it.

Input Parameters

string
required
New name for the pathway folder.
string
required
ID of the pathway folder to rename.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_RESOLVE_CONTACTFind 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

string
Name to use if a contact is created or enriched.
string
Contact email; at least one identifier is required.
object
Custom contact metadata.
string
Persona for optional memory scoping.
string
Caller-owned external identifier; at least one identifier is required.
string
Agent phone number for optional memory scoping.
string
Contact phone number; at least one identifier is required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_SYNTHESIZE_SPEECHGenerate 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

string
required
Text to synthesize, up to 5,000 characters.
object
Audio encoding and sample-rate settings. Output is always WAV.
string
required
UUID of a BTTS_V2 or BTTS_V3 voice returned by List Voices.
object
Optional voice expressiveness and stability controls.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_UPDATE_CONTACTUpdate 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

string
Updated contact name.
string
Email identifier to add or update.
object
Custom metadata keys to merge.
string
required
Contact to update.
string
External identifier to add or update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLAND_AI_UPDATE_CONTACT_FACTSMerge 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

object
required
Structured key-value facts to merge into the contact memory. Existing keys not included here are retained.
string
required
Contact memory record to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not