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.
| Method | POST |
| Path | /v1/sessions/:id/completion/read |
| Auth | Authorization: Bearer <token> required when GATEWAY_AUTH_TOKEN is set |
| Category | sessions |
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.