Schedules API: Run Hosted Agents on a Cron

A schedule runs a prompt on a hosted agent at the times a cron expression sets. Each run lands as a turn in your direct thread with the agent, so reports show up where you created the schedule. Use these endpoints to automate recurring work such as daily reports or nightly checks. To control which services a scheduled run can reach, see Agent access.

Endpoints

Endpoint	Method and path	What it does
List an agent’s schedules	`GET /agents/{agentId}/crons`	List every cron schedule on a hosted agent, with its prompt, cron expression, and next run time.
Create a schedule	`POST /agents/{agentId}/crons`	Create a cron schedule that sends a prompt to a hosted agent on a recurring basis, such as a daily report or nightly check.
Update, pause, or resume a schedule	`PATCH /agents/{agentId}/crons/{cronId}`	Change a schedule’s prompt or cron expression, or pause and resume it without deleting it.
Delete a schedule	`DELETE /agents/{agentId}/crons/{cronId}`	Permanently delete a cron schedule from a hosted agent.
Run a schedule now	`POST /agents/{agentId}/crons/{cronId}/run`	Trigger a schedule immediately instead of waiting for its next cron time.

Next steps

API overview: base URLs, authentication, and pagination
Errors: status codes and the error format
Editions: which endpoints each edition serves

Workspace

Organization

Enterprise

Platform

Schedules API: Run Hosted Agents on a Cron

Endpoints

Next steps

​Related guides

​Endpoints

​Next steps

Related guides

Endpoints

Next steps