GET/work/schedulesmember

Standing work: each schedule, its cadence, when it runs next, and its last run.

Query

selfonly this self's
POST/work/schedulesadmin

Give 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

selfhandle
kindtask|research
title
instructions
every_hours1..672, default 24
at_hour0..23 or null
weekdays[1..7] ISO, or null for every day
review_requiredtrue holds the output for a person
deliveran object your product reads when it is done, e.g. {slack: true}
statusactive|paused
bywho
PATCH/work/schedules/:idadmin

Change a schedule. A new cadence counts from its last run.

Body

...any field of POST /work/schedules except self
DELETE/work/schedules/:idadmin

Remove a schedule. Its items stay.

POST/work/schedules/:id/runadmin

Run it now, unless an item of it is already queued or running. Its cadence is untouched.

Body

bywho
POST/work/itemsmember

Ask 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

selfhandle
titlewhat you would like done
instructions
requested_bywho
kindrequest|handoff
parent_idthe item this was handed on from
start_afteroptional ISO 8601 date and time with its offset, at most 366 days ahead, such as 2026-12-01T09:00:00Z
GET/work/itemsmember

Items newest first, a page at a time, with counts per local day and status.

Query

selfonly this self's
statusqueued|running|needs_review|approved|rejected|done|failed
dayYYYY-MM-DD, local
beforethe last id of the previous page
limit1..100
dayshow many days of counts, default 14
GET/work/items/:idmember

One item, its output {text, sources, summary}, and its schedule.

POST/work/items/:id/retrymember

Put a failed item back in the queue, as it was asked.

POST/work/items/:id/deliveriesmember

Record what your product did with a finished item's output on one channel (the core delivers nowhere itself). Replaces that channel's record.

Body

channele.g. slack
results[{channel, posted, why?}] or whatever your product reports
POST/work/items/:id/reviewadmin

Decide an item that waited for review.

Body

decisionapproved|rejected
bywho
notewhy
rating-2..5
A glass tree whose crown holds many small worlds like fruit

Which world will you live in?

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