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

> Retrieve all versions of 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 whose versions to retrieve.
</ParamField>

### Response

<ResponseField name="data" type="array">
  Array of version objects ordered by version number (newest first).

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

    <ResponseField name="persona_id" type="string">
      ID of the parent persona.
    </ResponseField>

    <ResponseField name="version_type" type="string">
      Version type: `production`, `draft`, or `archived`.
    </ResponseField>

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

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

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

    <ResponseField name="pathway_conditions" type="array">
      Array of pathway routing conditions (null if none).
    </ResponseField>

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

    <ResponseField name="call_config" type="object">
      Call configuration settings (null if none).
    </ResponseField>

    <ResponseField name="default_tools" type="array">
      Array of default tools enabled for this version.
    </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 (null if not promoted).
    </ResponseField>

    <ResponseField name="promoted_by" type="string">
      User who promoted this version (null if auto or not promoted).
    </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="errors" type="string">
  Any errors that occurred (null if none).
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "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 helpful assistant",
        "pathway_conditions": null,
        "kb_ids": [],
        "call_config": null,
        "default_tools": [],
        "promoted_from_version_id": "12345678-1234-1234-1234-123456789012",
        "promoted_at": null,
        "promoted_by": null,
        "created_at": "2025-09-23T15:13:36.390Z",
        "updated_at": "2025-09-23T15:13:36.390Z"
      },
      {
        "id": "12345678-1234-1234-1234-123456789013",
        "persona_id": "12345678-1234-1234-1234-123456789012",
        "version_type": "production",
        "version_number": 1,
        "orchestration_prompt": null,
        "personality_prompt": "You are a helpful assistant",
        "pathway_conditions": null,
        "kb_ids": [],
        "call_config": null,
        "default_tools": [],
        "promoted_from_version_id": null,
        "promoted_at": "2025-09-23T15:13:36.368Z",
        "promoted_by": null,
        "created_at": "2025-09-23T15:13:36.369Z",
        "updated_at": "2025-09-23T15:13:36.369Z"
      }
    ],
    "errors": null
  }
  ```
</ResponseExample>

***

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