v6

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01485121699.8 KB

Post Bulletin

Append a message to the bulletin board.

Returns 201 when the message is stored and any registered signal action ran. When a signal action hook fails (for example a blocker whose clearance gate did not materialize), the message is still on the append-only board and queued in the board's retry outbox, but the action is not complete: the response is 202 rather than 201 so the caller can tell "stored and acted on" from "stored, action pending retry" (#2648).

post/bulletin

Request body

agent_idstring required
type'alert' | 'blocker' | 'finding' | 'status' | 'dependency'
contentstring required
cell_idstring nullable

Response

Successful Response

agent_idstring required
typestring required
contentstring required
timestampnumber required
cell_idstring nullable required