MINARA

Mark a session result as viewed

POST /v1/sessions/:id/completion/read — Idempotently acknowledge the latest completed or failed agent turn for a session. This clears `has_unseen_completion` an

POST /v1/sessions/:id/completion/read

Idempotently acknowledge the latest completed or failed agent turn for a session. This clears has_unseen_completion and broadcasts a session_completion_read event on the global WebSocket sessions channel.

MethodPOST
Path/v1/sessions/:id/completion/read
AuthAuthorization: Bearer <token> required when GATEWAY_AUTH_TOKEN is set
Categorysessions

Response body

{ "ok": true, "has_unseen_completion": false, "seen_at_ms": 1747000500000 }

Notes

Returns 404 {"error":"session_not_found"} for an unknown id. Calling the endpoint more than once has the same successful result. seen_at_ms is the acknowledged completion cursor and is null when the session has no completed or failed agent turn.

On this page