API reference

Personas

List the personas available in your workspace.

GET /personas/available#

List your configured personas. Use the returned id values with the persona_id parameter in POST /zo/ask to override the active persona.

curl https://api.zo.computer/personas/available \
  -H "Authorization: Bearer zo_sk_your_key_here"

Response#

{
  "personas": [
    {
      "id": "a1b2c3d4",
      "name": "Technical Writer",
      "prompt": "You are a concise technical writer...",
      "model": "anthropic:claude-sonnet-4",
      "image": null
    }
  ]
}

personasarray

List of configured personas.

personas[].idstring

The value to pass to persona_id in /zo/ask.

personas[].namestring

Display name for the persona.

personas[].promptstring

System prompt defining the persona's behavior.

personas[].modelstring | null

AI model ID, or null for the system default.

personas[].imagestring | null

Avatar image URL.