POST /persona/get
Get Persona
Get persona information using the canonical shared persona operation.
Request Body (GetPersonaApiRequest)
| Field | Type | Required | Description |
|---|---|---|---|
id | string | No | UUID of the persona to retrieve |
draft_id | string | No | UUID of the draft to load instead of published state |
snapshot_key | string | No | Cache snapshot key for consistent reads across related requests |
names | app__infra__persona__types__SectionFilter | No | Filter options for names section |
descriptions | app__infra__persona__types__SectionFilter | No | Filter options for descriptions section |
colors | app__infra__persona__types__SectionFilter | No | Filter options for colors section |
icons | app__infra__persona__types__SectionFilter | No | Filter options for icons section |
instructions | app__infra__persona__types__SectionFilter | No | Filter options for instructions section |
departments | app__infra__persona__types__SectionFilter | No | Filter options for departments section |
examples | app__infra__persona__types__SectionFilter | No | Filter options for examples section |
parameter_fields | app__infra__persona__types__SectionFilter | No | Filter options for parameter fields section |
voices | app__infra__persona__types__SectionFilter | No | Filter options for voices section |
Response (GetPersonaApiResponse)
| Field | Type | Required | Description |
|---|---|---|---|
actor_name | string | No | Display name of the authenticated user |
persona_exists | boolean | No | Whether the requested persona exists |
can_edit | boolean | No | Whether the current user has edit permission |
disabled_reason | string | No | Human-readable reason if editing is disabled |
group_id | string | No | Generation group UUID for AI operations |
draft_name | string | No | Immutable draft label from the active draft entry, when a draft_id was supplied. None for non-draft fetches. The FE uses this to show the draft name in the SaveToolbar trigger. |
show_ai_generate | boolean | No | Whether AI generation is available |
names | PersonaNameResource[] | No | Name resources with selected/suggested flags |
descriptions | PersonaDescriptionResource[] | No | Description resources with selected/suggested flags |
colors | PersonaColorResource[] | No | Color resources with selected/suggested flags |
icons | PersonaIconResource[] | No | Icon resources with selected/suggested flags |
instructions | PersonaInstructionResource[] | No | Instruction resources with selected/suggested flags |
flags | PersonaFlagResource[] | No | Flag resources (one per flags_resource row, value=true/false) |
departments | PersonaDepartmentResource[] | No | Department resources with selected/suggested flags |
parameter_fields | PersonaParameterFieldResource[] | No | Parameter field resources with selected/suggested flags |
examples | PersonaExampleResource[] | No | Example resources with selected/suggested flags |
parameters | any[] | No | Parameter resources |
voices | PersonaVoiceResource[] | No | Voice resources with selected/suggested flags |
fields | GetFieldResponse[] | No | All available field definitions (computed, never saved) |
resolved_parameter_ids | string[] | No | Parameter IDs derived from saved parameter_fields |
Last updated on