Schedules
Cron-driven agent runs scoped to a workspace.
Cron schedules fire agent prompts on a timetable. Each schedule belongs to an org and workspace and references one agent.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/v1/schedules | List schedules visible to the caller. |
POST | /api/v1/schedules | Create a schedule (cron expression + prompt + agent). |
PATCH | /api/v1/schedules/:id | Update cron, prompt, enabled flag, or agent binding. |
DELETE | /api/v1/schedules/:id | Delete a schedule. |
Create
POST /api/v1/schedules accepts a cron expression, natural-language or structured prompt, target agentId, and workspaceId. Failed runs surface as org notifications — see Notifications.
Errors
| Code | When |
|---|---|
BAD_REQUEST | Invalid cron, missing agent, or workspace outside caller scope. |
FORBIDDEN | Schedule belongs to another org. |
NOT_FOUND | Unknown schedule id. |