> ## 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

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Query Parameters

<ParamField query="page" type="integer" default="1">
  Page number for pagination.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Number of personas to return per page (max 100).
</ParamField>

### Response

<ResponseField name="data" type="array">
  Array of persona objects.

  <Expandable title="persona object">
    <ResponseField name="id" type="string">
      Unique identifier for the persona.
    </ResponseField>

    <ResponseField name="name" type="string">
      Display name of the persona.
    </ResponseField>

    <ResponseField name="role" type="string">
      Role assigned to the persona.
    </ResponseField>

    <ResponseField name="description" type="string">
      Description of the persona's purpose.
    </ResponseField>

    <ResponseField name="tags" type="array">
      Array of tags associated with the persona.
    </ResponseField>

    <ResponseField name="image_url" type="string">
      URL of the persona's profile image (null if none).
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the persona was created.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp of when the persona was last modified.
    </ResponseField>

    <ResponseField name="deleted_at" type="string">
      ISO 8601 timestamp of when the persona was deleted (null if active).
    </ResponseField>

    <ResponseField name="user_id" type="string">
      ID of the user who owns this persona.
    </ResponseField>

    <ResponseField name="current_production_version_id" type="string">
      ID of the current production version.
    </ResponseField>

    <ResponseField name="current_draft_version_id" type="string">
      ID of the current draft version.
    </ResponseField>

    <ResponseField name="inbound_numbers" type="array">
      Array of inbound phone numbers using this persona.
    </ResponseField>

    <ResponseField name="current_production_version" type="object">
      Complete production version object.

      <Expandable title="version object">
        <ResponseField name="id" type="string">
          Version identifier.
        </ResponseField>

        <ResponseField name="persona_id" type="string">
          Parent persona identifier.
        </ResponseField>

        <ResponseField name="version_type" type="string">
          Type of version: `production` or `draft`.
        </ResponseField>

        <ResponseField name="version_number" type="integer">
          Sequential version number.
        </ResponseField>

        <ResponseField name="orchestration_prompt" type="string">
          Orchestration prompt (null if none).
        </ResponseField>

        <ResponseField name="personality_prompt" type="string">
          Personality and behavior prompt.
        </ResponseField>

        <ResponseField name="pathway_conditions" type="array">
          Array of pathway routing conditions.
        </ResponseField>

        <ResponseField name="kb_ids" type="array">
          Array of knowledge base IDs.
        </ResponseField>

        <ResponseField name="call_config" type="object">
          Call configuration settings.
        </ResponseField>

        <ResponseField name="default_tools" type="array">
          Array of default tools enabled.
        </ResponseField>

        <ResponseField name="promoted_from_version_id" type="string">
          Version ID this was promoted from (null if initial).
        </ResponseField>

        <ResponseField name="promoted_at" type="string">
          When this version was promoted to production.
        </ResponseField>

        <ResponseField name="promoted_by" type="string">
          User who promoted this version (null if auto).
        </ResponseField>

        <ResponseField name="created_at" type="string">
          When this version was created.
        </ResponseField>

        <ResponseField name="updated_at" type="string">
          When this version was last updated.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="current_draft_version" type="object">
      Complete draft version object (same structure as production version).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="errors" type="string">
  Any errors that occurred (null if none).
</ResponseField>

<ResponseExample>
  ```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
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)