/work/schedulesmemberStanding work: each schedule, its cadence, when it runs next, and its last run.
Query
self | only this self's |
API ยท 11 operations
Standing work a self does on its own schedule.
/work/schedulesmemberStanding work: each schedule, its cadence, when it runs next, and its last run.
Query
self | only this self's |
/work/schedulesadminGive a self standing work. A task answers its instructions; research reads the web for its topics (one per line) into the self's memory. Times are the tenant's timezone.
Body
self | handle |
kind | task|research |
title | |
instructions | |
every_hours | 1..672, default 24 |
at_hour | 0..23 or null |
weekdays | [1..7] ISO, or null for every day |
review_required | true holds the output for a person |
deliver | an object your product reads when it is done, e.g. {slack: true} |
status | active|paused |
by | who |
/work/schedules/:idadminChange a schedule. A new cadence counts from its last run.
Body
... | any field of POST /work/schedules except self |
/work/schedules/:idadminRemove a schedule. Its items stay.
/work/schedules/:id/runadminRun it now, unless an item of it is already queued or running. Its cadence is untouched.
Body
by | who |
/work/itemsmemberAsk a self for one piece of work. It is run as a `work` job; watch for work.done in /events. With start_after (added in contract version 1, additive) it is one-off work at a set time: the item waits queued and is not started before then; a time already past starts it at once.
Body
self | handle |
title | what you would like done |
instructions | |
requested_by | who |
kind | request|handoff |
parent_id | the item this was handed on from |
start_after | optional ISO 8601 date and time with its offset, at most 366 days ahead, such as 2026-12-01T09:00:00Z |
/work/itemsmemberItems newest first, a page at a time, with counts per local day and status.
Query
self | only this self's |
status | queued|running|needs_review|approved|rejected|done|failed |
day | YYYY-MM-DD, local |
before | the last id of the previous page |
limit | 1..100 |
days | how many days of counts, default 14 |
/work/items/:idmemberOne item, its output {text, sources, summary}, and its schedule.
/work/items/:id/retrymemberPut a failed item back in the queue, as it was asked.
/work/items/:id/deliveriesmemberRecord what your product did with a finished item's output on one channel (the core delivers nowhere itself). Replaces that channel's record.
Body
channel | e.g. slack |
results | [{channel, posted, why?}] or whatever your product reports |
/work/items/:id/reviewadminDecide an item that waited for review.
Body
decision | approved|rejected |
by | who |
note | why |
rating | -2..5 |

What grows here is meant to reach the real world. Start with a world of your own.