Skip to main content
PUT
/
events
/
{agent_id}
Update Agent
curl --request PUT \
  --url https://api.zo.computer/events/{agent_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "rrule": "<string>",
  "instruction": "<string>",
  "title": "<string>",
  "result_delivery_method": "email",
  "model": "<string>",
  "active": true
}
'
{
  "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_...)

Path Parameters

​
agent_id
string
required

Body

application/json
​
rrule
string | null

New recurrence rule in iCalendar RRULE format

​
instruction
string | null

New instructions for the agent

​
title
string | null

New human-readable name

​
result_delivery_method
enum<string> | null

How to notify on completion: 'email', 'sms', or null to disable

Available options:
email,
sms
​
model
string | null

AI model ID to use

​
active
boolean | null

Set to false to pause the agent without deleting

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