Skip to main content
POST
/
personas
Create Persona
curl --request POST \
  --url https://api.zo.computer/personas/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "prompt": "<string>",
  "model": "<string>",
  "image": "<string>"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "prompt": "<string>",
  "model": "<string>",
  "image": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>"
}

Authorizations

​
Authorization
string
header
required

Zo API key (zo_sk_...)

Body

application/json
​
name
string
required

Display name for the persona

Maximum string length: 64
​
prompt
string
required

System prompt that defines the persona's behavior

Maximum string length: 10000
​
model
string | null

AI model ID to use (defaults to system default)

​
image
string | null

URL to avatar image

Response

Successful Response

​
id
string
required

Unique persona identifier

​
name
string
required

Display name

​
prompt
string
required

System prompt defining behavior

​
model
string | null
required

AI model ID, or null for system default

​
image
string | null
required

Avatar image URL

​
created_at
string
required

ISO 8601 creation timestamp

​
updated_at
string
required

ISO 8601 last update timestamp