List chat sessions

GET /v1/sessions

List the user's chat sessions with last-activity timestamp and message count, most recently updated first. kind scopes to one surface's sessions (including messaging for IM-bridged conversations); origin scopes by creator (web | cli | automation | messaging). Unknown filter values leave that dimension unfiltered.

Response body

{ "sessions": [ { "id": "chat_abc", "title": "BTC analysis", "origin": "web", "kind": "chat", "created_at_ms": 1747000000000, "updated_at_ms": 1747000500000, "message_count": 6, "has_unseen_completion": true, "completion_settled_at_ms": 1747000500000 } ] }

Notes

has_unseen_completion is true after a non-interrupted turn completes or fails, until the client acknowledges the result with POST /v1/sessions/:id/completion/read. completion_settled_at_ms is the stable cursor for that result; clients can use it to ignore stale list snapshots after acknowledgement.