Calls
Conversational Pathways
Knowledge Bases
Numbers
Blocked Numbers
Voices
Widgets
Custom Tools
Memory
Guard Rails
Web Agents
Custom Twilio Accounts
Account
Organizations
- POSTCreate Organization
- DELDelete Organization
- GETGet Organization
- GETGet Organization Members
- GETGet Organization's Current Service Version
- GETList Organization's Service Versions
- PATCHUpdate Organization's Service Version
- PATCHUpdate Organization Members
- PATCHUpdate Organization Member Permissions
- PATCHUpdate Organization Properties
- GETGet User Organization Memberships
- DELLeave Organization
- GETGet Organization Billing Information
- GETGet Organization Billing Refill Information
SMS
Custom Dialing Pools
Personas
List Personas
Copy
Ask AI
curl --request GET \
--url https://api.bland.ai/v1/personas \
--header 'authorization: <authorization>'Copy
Ask AI
{
"data": [
{
"id": "12345678-1234-1234-1234-123456789012",
"name": "Customer Support Agent",
"role": "Customer Support",
"description": "A capable customer support agent",
"tags": ["Customer Support"],
"image_url": null,
"created_at": "2025-09-16T23:54:44.420Z",
"updated_at": "2025-09-16T23:54:59.896Z",
"deleted_at": null,
"user_id": "12345678-1234-1234-1234-123456789012",
"current_production_version_id": "12345678-1234-1234-1234-123456789012",
"current_draft_version_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"current_production_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789012",
"version_type": "production",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful customer support agent",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-16T23:54:44.441Z",
"promoted_by": null,
"created_at": "2025-09-16T23:54:44.442Z",
"updated_at": "2025-09-16T23:54:44.442Z"
},
"current_draft_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789012",
"version_type": "draft",
"version_number": 2,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful customer support agent",
"pathway_conditions": [
{
"name": "",
"prompt": "",
"pathway_id": "",
"start_node_id": "",
"pathway_version": ""
},
{
"name": "",
"prompt": "",
"pathway_id": "",
"start_node_id": "",
"pathway_version": ""
}
],
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": "12345678-1234-1234-1234-123456789012",
"promoted_at": null,
"promoted_by": null,
"created_at": "2025-09-16T23:54:44.463Z",
"updated_at": "2025-09-16T23:54:59.917Z"
}
},
{
"id": "12345678-1234-1234-1234-123456789013",
"name": "Sales Representative",
"role": "Sales",
"description": "A capable sales representative",
"tags": ["Sales"],
"image_url": null,
"created_at": "2025-09-23T14:40:01.089Z",
"updated_at": "2025-09-23T14:40:01.153Z",
"deleted_at": null,
"user_id": "12345678-1234-1234-1234-123456789012",
"current_production_version_id": "12345678-1234-1234-1234-123456789012",
"current_draft_version_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"current_production_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "production",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful sales representative",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-23T14:40:01.109Z",
"promoted_by": null,
"created_at": "2025-09-23T14:40:01.110Z",
"updated_at": "2025-09-23T14:40:01.110Z"
},
"current_draft_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "draft",
"version_number": 2,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful sales representative",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": "12345678-1234-1234-1234-123456789012",
"promoted_at": null,
"promoted_by": null,
"created_at": "2025-09-23T14:40:01.132Z",
"updated_at": "2025-09-23T14:40:01.132Z"
}
}
],
"errors": null
}
Personas
List Personas
Retrieve a list of all personas in your organization.
GET
https://api.bland.ai
/
v1
/
personas
List Personas
Copy
Ask AI
curl --request GET \
--url https://api.bland.ai/v1/personas \
--header 'authorization: <authorization>'Copy
Ask AI
{
"data": [
{
"id": "12345678-1234-1234-1234-123456789012",
"name": "Customer Support Agent",
"role": "Customer Support",
"description": "A capable customer support agent",
"tags": ["Customer Support"],
"image_url": null,
"created_at": "2025-09-16T23:54:44.420Z",
"updated_at": "2025-09-16T23:54:59.896Z",
"deleted_at": null,
"user_id": "12345678-1234-1234-1234-123456789012",
"current_production_version_id": "12345678-1234-1234-1234-123456789012",
"current_draft_version_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"current_production_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789012",
"version_type": "production",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful customer support agent",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-16T23:54:44.441Z",
"promoted_by": null,
"created_at": "2025-09-16T23:54:44.442Z",
"updated_at": "2025-09-16T23:54:44.442Z"
},
"current_draft_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789012",
"version_type": "draft",
"version_number": 2,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful customer support agent",
"pathway_conditions": [
{
"name": "",
"prompt": "",
"pathway_id": "",
"start_node_id": "",
"pathway_version": ""
},
{
"name": "",
"prompt": "",
"pathway_id": "",
"start_node_id": "",
"pathway_version": ""
}
],
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": "12345678-1234-1234-1234-123456789012",
"promoted_at": null,
"promoted_by": null,
"created_at": "2025-09-16T23:54:44.463Z",
"updated_at": "2025-09-16T23:54:59.917Z"
}
},
{
"id": "12345678-1234-1234-1234-123456789013",
"name": "Sales Representative",
"role": "Sales",
"description": "A capable sales representative",
"tags": ["Sales"],
"image_url": null,
"created_at": "2025-09-23T14:40:01.089Z",
"updated_at": "2025-09-23T14:40:01.153Z",
"deleted_at": null,
"user_id": "12345678-1234-1234-1234-123456789012",
"current_production_version_id": "12345678-1234-1234-1234-123456789012",
"current_draft_version_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"current_production_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "production",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful sales representative",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-23T14:40:01.109Z",
"promoted_by": null,
"created_at": "2025-09-23T14:40:01.110Z",
"updated_at": "2025-09-23T14:40:01.110Z"
},
"current_draft_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "draft",
"version_number": 2,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful sales representative",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": "12345678-1234-1234-1234-123456789012",
"promoted_at": null,
"promoted_by": null,
"created_at": "2025-09-23T14:40:01.132Z",
"updated_at": "2025-09-23T14:40:01.132Z"
}
}
],
"errors": null
}
Headers
Your API key for authentication.
Query Parameters
Page number for pagination.
Number of personas to return per page (max 100).
Response
Array of persona objects.
Show persona object
Show persona object
Unique identifier for the persona.
Display name of the persona.
Role assigned to the persona.
Description of the persona’s purpose.
Array of tags associated with the persona.
URL of the persona’s profile image (null if none).
ISO 8601 timestamp of when the persona was created.
ISO 8601 timestamp of when the persona was last modified.
ISO 8601 timestamp of when the persona was deleted (null if active).
ID of the user who owns this persona.
ID of the current production version.
ID of the current draft version.
Array of inbound phone numbers using this persona.
Complete production version object.
Show version object
Show version object
Version identifier.
Parent persona identifier.
Type of version:
production or draft.Sequential version number.
Orchestration prompt (null if none).
Personality and behavior prompt.
Array of pathway routing conditions.
Array of knowledge base IDs.
Call configuration settings.
Array of default tools enabled.
Version ID this was promoted from (null if initial).
When this version was promoted to production.
User who promoted this version (null if auto).
When this version was created.
When this version was last updated.
Complete draft version object (same structure as production version).
Any errors that occurred (null if none).
Copy
Ask AI
{
"data": [
{
"id": "12345678-1234-1234-1234-123456789012",
"name": "Customer Support Agent",
"role": "Customer Support",
"description": "A capable customer support agent",
"tags": ["Customer Support"],
"image_url": null,
"created_at": "2025-09-16T23:54:44.420Z",
"updated_at": "2025-09-16T23:54:59.896Z",
"deleted_at": null,
"user_id": "12345678-1234-1234-1234-123456789012",
"current_production_version_id": "12345678-1234-1234-1234-123456789012",
"current_draft_version_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"current_production_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789012",
"version_type": "production",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful customer support agent",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-16T23:54:44.441Z",
"promoted_by": null,
"created_at": "2025-09-16T23:54:44.442Z",
"updated_at": "2025-09-16T23:54:44.442Z"
},
"current_draft_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789012",
"version_type": "draft",
"version_number": 2,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful customer support agent",
"pathway_conditions": [
{
"name": "",
"prompt": "",
"pathway_id": "",
"start_node_id": "",
"pathway_version": ""
},
{
"name": "",
"prompt": "",
"pathway_id": "",
"start_node_id": "",
"pathway_version": ""
}
],
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": "12345678-1234-1234-1234-123456789012",
"promoted_at": null,
"promoted_by": null,
"created_at": "2025-09-16T23:54:44.463Z",
"updated_at": "2025-09-16T23:54:59.917Z"
}
},
{
"id": "12345678-1234-1234-1234-123456789013",
"name": "Sales Representative",
"role": "Sales",
"description": "A capable sales representative",
"tags": ["Sales"],
"image_url": null,
"created_at": "2025-09-23T14:40:01.089Z",
"updated_at": "2025-09-23T14:40:01.153Z",
"deleted_at": null,
"user_id": "12345678-1234-1234-1234-123456789012",
"current_production_version_id": "12345678-1234-1234-1234-123456789012",
"current_draft_version_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"current_production_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "production",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful sales representative",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-23T14:40:01.109Z",
"promoted_by": null,
"created_at": "2025-09-23T14:40:01.110Z",
"updated_at": "2025-09-23T14:40:01.110Z"
},
"current_draft_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "draft",
"version_number": 2,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful sales representative",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": "12345678-1234-1234-1234-123456789012",
"promoted_at": null,
"promoted_by": null,
"created_at": "2025-09-23T14:40:01.132Z",
"updated_at": "2025-09-23T14:40:01.132Z"
}
}
],
"errors": null
}
Was this page helpful?
⌘I