Skip to main content
PUT
Update one backlog item

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
id
string
required
scope
enum<string>

user always means the caller's own document

Available options:
organisation,
user
status
enum<string>
Available options:
pending,
in_progress,
done,
awaiting_user,
cancelled
content
string
details
string

An explicit empty string clears it; a blank content is refused

follow_up_at
string<date-time>

Must be sent together with status: awaiting_user

approved_tool_ids
string[]

Answer to the consent card that parked this item. Not stored — forwarded on the work event so the resuming run carries the consent. Ignored unless the patch un-parks the item.

approved_server_ids
string[]

"Just this once" server approvals. Forwarded, never stored — an approval that settled on the item would become the standing grant the Authorise button exists to make deliberate.

denied_server_ids
string[]

Forwarded, never stored

Response

The item as updated

id
string
content
string

The one-line item

details
string

Long-form context behind content

status
enum<string>
Available options:
pending,
in_progress,
done,
awaiting_user,
cancelled
owner_user_id
string

Mesh identity of the item's owner

session_id
string
blocked_on
string
follow_up_at
string<date-time>

"Chase the person this item is parked on" — only meaningful on an awaiting_user item

kind
string
scheduled_for
string<date-time>
cron
string
created
string<date-time>
updated
string<date-time>
scope
enum<string>

Added by the read/write handlers; not part of the stored document

Available options:
organisation,
user