Automation Endpoints
Last updated
Endpoints for scheduled runs.
Cron entries and one-off tasks are one surface. The separate
/v1/cron* and /v1/task* endpoints were replaced by /v1/schedule in v0.33.6, with type=cron|task selecting between them.| Method | Path | Description |
|---|---|---|
GET | /v1/schedule | local — list cron entries and one-off tasks as one schedules array, each tagged type=cron|task; ?type= narrows to one |
GET | /v1/schedule/*skill | local — read a scheduler skill (404 when missing): name (also echoed as skill) plus body, which since v1.0.2 is the raw SKILL.md including its frontmatter rather than the parsed-off body. files carries the skill's scripts/ references/ assets/ contents on the same terms as GET /v1/skill/*name. The description field was removed |
POST PATCH | /v1/schedule | local — {type, name, content, expressions, session_id?}. Creates (POST, 409 when the name is taken) or updates (PATCH, 404 when missing) a scheduler skill and rebind its whole entry set to type=cron|task; switching type drops the entries the skill held under the other one. description was removed in v1.0.2. A content that already opens with its own --- frontmatter is written verbatim; otherwise the server composes a minimal ---\nname: <name>\n--- header. name is 1-64 characters of A-Z a-z 0-9 _ -. expressions (at least one) are cron expressions for cron and future times for task (+<duration>, YYYY-MM-DD HH:MM, RFC 3339, or HH:MM today). session_id defaults to the session the skill already runs in, else a new chat- session. Returns {type, name, session_id} |
DELETE | /v1/schedule | local — {skill, type?}. Deletes a skill's entries (type narrows to one, omitted removes both) and trashes the skill when nothing else binds it; returns {ok, removed, trashed}, 404 when nothing was removed |
POST | /v1/schedule/run | local — {session_id, skill}, both required. Fires a schedule now and returns 202 {ok, started:true} without waiting for the run |