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

# Get Persona

> Retrieve a specific persona.

### Headers

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

### Path Parameters

<ParamField path="persona_id" type="string" required>
  The unique identifier of the persona to retrieve.
</ParamField>

### Response

<ResponseField name="data" type="object">
  The persona object.

  <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"
      }
    },
    "errors": null
  }
  ```
</ResponseExample>

***

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