Build with the API

Personas

Create, publish, and deploy AI personas, then track their conversations.

Lifecycle

Personas are AI characters you create, publish, and deploy. Draft them, iterate, then publish when ready:

GET/personasList personas.POST/personasCreate a persona.GET/personas/{id}Get a persona.PATCH/personas/{id}Update a persona.DELETE/personas/{id}Delete a persona.POST/personas/{id}/publishPublish a persona.

Deployments

Expose a published persona on a channel:

GET/personas/{id}/deploymentsList deployments.POST/personas/{id}/deploymentsCreate a deployment.

Conversations

Start sessions with a persona and inspect what happened:

POST/personas/{id}/conversationsStart a conversation.POST/personas/{id}/conversations/{cid}/endEnd a conversation.GET/personas/{id}/conversations/{cid}/eventsList conversation events.

Faces

Browse the visual identities a persona can wear: the shared stock library plus the likenesses you trained. Faces are owned, so another account's likeness never appears here, and a face that is still training is refused until it is ready.

GET/personas/facesList available persona faces (stock + yours).

Cloning a likeness or a voice from a recording is done in the persona Studio or over MCP (create_persona_face, create_persona_voice). To make an external agent the brain behind a persona, see Agent Link.

Schemas

Persona bodies are richest in the API reference; start from a GET response and PATCH the fields you need.