Notifications
CompozyOS Notifications HTTP endpoints.
GET
receipt_profile?stringProfile owning acknowledgement receipts, including aggregate reads
workspace?stringHome workspace scope; empty selects global tasks
all_workspaces?booleanEvery project's tasks, matching an All projects Home overview
profile?stringRead one profile's rows by name
all_profiles?booleanRead the owner-labeled all-profiles aggregate
Exact counts and first 100 rows; snapshot includes every occurrence
application/json- response
finished*integeritems*array<>needs_you*integersnapshot*stringtotal*integercurl -X GET "https://example.com/api/notifications/attention"{ "finished": 0, "items": [ { "agent_name": "string", "badge": "string", "detail": "string", "finished": true, "generation": 0, "id": "string", "item_index": 0, "kind": "string", "loop_name": "string", "node_id": "string", "occurred_at": "2019-08-24T14:15:22Z", "redacted": true, "request_kind": "string", "run_id": "string", "source_id": "string", "terminal_id": "string", "title": "string", "workspace_id": "string", "workspace_label": "string" } ], "needs_you": 0, "snapshot": "string", "total": 0}POST
receipt_profile?stringProfile owning acknowledgement receipts, including aggregate reads
workspace?stringHome workspace scope; empty selects global tasks
all_workspaces?booleanEvery project's tasks, matching an All projects Home overview
profile?stringRead one profile's rows by name
all_profiles?booleanRead the owner-labeled all-profiles aggregate
surface?stringSnapshot owner (default bell)
Value in
"bell""home"JSON request body
application/json- body
id?stringsnapshot*stringReceipts committed atomically; source state unchanged
curl -X POST "https://example.com/api/notifications/attention/acknowledge" \ -H "Content-Type: application/json" \ -d '{ "snapshot": "string" }'Empty