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

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**persona\_id** `string` *required*

The unique identifier of the persona whose versions to retrieve.

### Response

**data** `array`

Array of version objects ordered by version number (newest first).

**version object**

**id** `string`

Unique identifier for this version.

**persona\_id** `string`

ID of the parent persona.

**version\_type** `string`

Version type: `production`, `draft`, or `archived`.

**version\_number** `integer`

Sequential version number.

**orchestration\_prompt** `string`

Orchestration prompt for this version (null if none).

**personality\_prompt** `string`

Personality and behavior prompt for this version.

**pathway\_conditions** `array`

Array of pathway routing conditions (null if none).

**kb\_ids** `array`

Array of knowledge base item IDs connected to this version.

**call\_config** `object`

Call configuration settings (null if none).

**default\_tools** `array`

Array of default tools enabled for this version.

**promoted\_from\_version\_id** `string`

Version ID this was promoted from (null if initial).

**promoted\_at** `string`

When this version was promoted to production (null if not promoted).

**promoted\_by** `string`

User who promoted this version (null if auto or not promoted).

**created\_at** `string`

When this version was created.

**updated\_at** `string`

When this version was last updated.

**errors** `string`

Any errors that occurred (null if none).

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

***

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.