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

# Promote Persona Version

> Promote a persona's draft version to production.

### 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 draft version should be promoted.
</ParamField>

### Response

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

  <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 (updated after promotion).
    </ResponseField>

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

    <ResponseField name="current_production_version" type="object">
      Complete production version object (the newly promoted version).
    </ResponseField>

    <ResponseField name="current_draft_version" type="object">
      Complete draft version object (same as before promotion).
    </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": "Blandy",
      "role": null,
      "description": "Helpful Agent for Bland Documentation",
      "tags": [],
      "image_url": null,
      "created_at": "2025-09-23T15:13:36.348Z",
      "updated_at": "2025-09-23T15:55:57.284Z",
      "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-123456789013",
      "current_production_version": {
        "id": "12345678-1234-1234-1234-123456789012",
        "persona_id": "12345678-1234-1234-1234-123456789012",
        "version_type": "production",
        "version_number": 3,
        "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-123456789013",
        "promoted_at": "2025-09-23T15:55:57.262Z",
        "promoted_by": "12345678-1234-1234-1234-123456789012",
        "created_at": "2025-09-23T15:55:57.263Z",
        "updated_at": "2025-09-23T15:55:57.263Z"
      },
      "current_draft_version": {
        "id": "12345678-1234-1234-1234-123456789013",
        "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"
      }
    },
    "errors": null
  }
  ```

  ```json Error Response (No Draft) theme={null}
  {
    "data": null,
    "errors": [
      {
        "error": "NO_DRAFT_VERSION",
        "message": "No draft version to promote",
        "details": {
          "persona_id": "12345678-1234-1234-1234-123456789012"
        }
      }
    ]
  }
  ```
</ResponseExample>

***

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