Headers
Your API key for authentication.
Path Parameters
The unique identifier of the persona whose draft version should be promoted.
Response
The updated persona object after promotion.
Show persona object
Show persona object
Unique identifier for the persona.
Display name of the persona.
Role assigned to the persona.
Description of the persona’s purpose.
Array of tags associated with the persona.
URL of the persona’s profile image (null if none).
ISO 8601 timestamp of when the persona was created.
ISO 8601 timestamp of when the persona was last modified.
ISO 8601 timestamp of when the persona was deleted (null if active).
ID of the user who owns this persona.
ID of the current production version (updated after promotion).
ID of the current draft version.
Complete production version object (the newly promoted version).
Complete draft version object (same as before promotion).
Any errors that occurred (null if none).
Copy
Ask AI
{
"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
}