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": 100
},
"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": 100
},
"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": 100
},
"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": 100
},
"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
}