Hand an endpoint you own a todo and ring its doorbell
POST/api/v1/endpoints/:ref/todos
The operator's hand (ADR-0026): mints one todo on the named endpoint and rings its
doorbell exactly as a verified delivery does. The hand-off is recorded as a delivery event
of source, family and trust mode operator, verified, whose verify_detail names the
authenticated human — so history and the board show who asked. Only the endpoint's owner
may push, only onto one of its vended queues; the title and payload reach the agent as
untrusted content like any todo's.
Request
Responses
- 201
- 400
- 401
- 404
- 409
The todo. created is false when key matched a live todo on the endpoint: the
existing todo is returned, nothing was minted, nothing was rung.
Invalid body, empty or over-long title, a queue outside the endpoint's vended scope, or no queue on an endpoint that drains several.
Missing, expired, revoked, or non-operator bearer.
No endpoint by that slug or id belongs to the caller (unknown and another operator's are the same answer).
The endpoint is revoked; nothing could ever drain the work.