add_cron_job

Adds a prompt that runs on a schedule in this chat.

Since 2 Sept 2026

Schedules are every Nh, every Nm or daily HH:MM in UTC. The scheduler checks every 30 seconds. A job with no earlier run starts at once. Runs can only use read-only tools.

Tool name: add_cron_job
Group: Scheduled jobs
Risk: medium
Needs approval: never
Approval rule: No approval at creation. The job itself is limited to a read-only tool list.
Allowed in scheduled jobs: No
Default: on

Parameters

Name	Type	Required	Meaning
name	string	Yes	A short name.
schedule	string	Yes	every Nh, every Nm, or daily HH:MM in UTC.
prompt	string	Yes	What the agent should do on each run.

Returns

The job id.

Example (made up for this page)

Call

{
  "name": "demo",
  "schedule": "demo",
  "prompt": "demo"
}

Result

Cron job added: 123456 (daily-summary) - daily 09:00. Runs in this chat.

Side effects

Writes the job list
Causes model calls later.

How it can fail

When	What the agent sees
Bad schedule text	The job never runs