Skip to main content
POST
/
events
Create Agent
curl --request POST \
  --url https://api.zo.computer/events/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "rrule": "<string>",
  "instruction": "<string>",
  "title": "<string>",
  "result_delivery_method": "email",
  "model": "<string>"
}
'
{
  "id": "<string>",
  "rrule": "<string>",
  "instruction": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>",
  "next_run": "<string>",
  "utc": true,
  "title": "<string>",
  "result_delivery_method": "email",
  "model": "<string>",
  "active": true
}

Authorizations

​
Authorization
string
header
required

Zo API key (zo_sk_...)

Body

application/json
​
rrule
string
required

Recurrence rule in iCalendar RRULE format (e.g., 'FREQ=DAILY;BYHOUR=9')

​
instruction
string
required

Instructions for what the agent should do when triggered

​
title
string | null

Human-readable name for the agent

​
result_delivery_method
enum<string> | null

How to notify on completion: 'email' or 'sms'

Available options:
email,
sms
​
model
string | null

AI model ID to use (defaults to system default)

Response

Successful Response

​
id
string
required

Unique agent identifier

​
rrule
string
required

Recurrence rule in iCalendar RRULE format

​
instruction
string
required

Instructions the agent executes

​
created_at
string
required

ISO 8601 creation timestamp

​
updated_at
string
required

ISO 8601 last update timestamp

​
next_run
string | null
required

ISO 8601 timestamp of next scheduled execution, or null if paused

​
utc
boolean | null

Whether times are in UTC

​
title
string | null

Human-readable name

​
result_delivery_method
enum<string> | null

Notification method on completion

Available options:
email,
sms
​
model
string | null

AI model ID used for execution

​
active
boolean
default:true

Whether the agent is active and will run on schedule