POST /persona/create
Create Persona
Create personas using composable infra architecture.
Request Body (CreatePersonaApiRequest)
| Field | Type | Required | Description |
|---|---|---|---|
personas | CreatePersonaItem[] | No | List of persona items to create (required on first call) |
idempotency_key | string | No | Idempotency key — safe-retry replay on the first call; ack of a dormant create when sent with accept |
soft | boolean | No | Stage the create dormant (active=False) — propose; the response echoes a server key to ack with ({idempotency_key, accept}) |
accept | boolean | No | Accept (promote) or reject dormant state. Only meaningful with idempotency_key |
Response (CreatePersonaApiResponse)
| Field | Type | Required | Description |
|---|---|---|---|
results | PersonaResultItem[] | Yes | Per-persona creation results |
idempotency_key | string | No | Idempotency key echoed back for client correlation |
personas | ListPersonaApiPersona[] | No | Hydrated rows for the successfully-created personas (mirrors /persona/search shape) |
Last updated on