> ## Documentation Index > Fetch the complete documentation index at: https://docs.bland.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Personas > Retrieve a list of all personas in your organization. ### Headers **authorization** `string` *required* Your API key for authentication. ### Query Parameters **page** `integer` (default: 1) Page number for pagination. **limit** `integer` (default: 20) Number of personas to return per page (max 100). ### Response **data** `array` Array of persona objects. **persona object** **id** `string` Unique identifier for the persona. **name** `string` Display name of the persona. **role** `string` Role assigned to the persona. **description** `string` Description of the persona's purpose. **tags** `array` Array of tags associated with the persona. **image\_url** `string` URL of the persona's profile image (null if none). **created\_at** `string` ISO 8601 timestamp of when the persona was created. **updated\_at** `string` ISO 8601 timestamp of when the persona was last modified. **deleted\_at** `string` ISO 8601 timestamp of when the persona was deleted (null if active). **user\_id** `string` ID of the user who owns this persona. **current\_production\_version\_id** `string` ID of the current production version. **current\_draft\_version\_id** `string` ID of the current draft version. **inbound\_numbers** `array` Array of inbound phone numbers using this persona. **current\_production\_version** `object` Complete production version object. **version object** **id** `string` Version identifier. **persona\_id** `string` Parent persona identifier. **version\_type** `string` Type of version: `production` or `draft`. **version\_number** `integer` Sequential version number. **orchestration\_prompt** `string` Orchestration prompt (null if none). **personality\_prompt** `string` Personality and behavior prompt. **pathway\_conditions** `array` Array of pathway routing conditions. **kb\_ids** `array` Array of knowledge base item IDs. **call\_config** `object` Call configuration settings. **default\_tools** `array` Array of default tools enabled. **promoted\_from\_version\_id** `string` Version ID this was promoted from (null if initial). **promoted\_at** `string` When this version was promoted to production. **promoted\_by** `string` User who promoted this version (null if auto). **created\_at** `string` When this version was created. **updated\_at** `string` When this version was last updated. **current\_draft\_version** `object` Complete draft version object (same structure as production version). **errors** `string` Any errors that occurred (null if none). ```json Response theme={null} { "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 } ``` *** Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.