List sessions
With an API key: the org's sessions the key can read, newest first, at most 100 (limit, default 50), optionally only one status, each in the shape GET /o/{org}/sessions/{session} returns (CloudRunSessionList). A key takes only status and limit.
With a signed-in session (the console): a search across every Project in the org, filtered by the other query parameters, in the console's browsing shape. With selector, it resolves exactly one session by full id, unique id prefix, or title; when it matches more than one, the answer is 409 with the candidates. These errors use {code, message}.
Request
- Base URL: https://api.prix.dev
- URL: https://api.prix.dev/o/{org}/sessions
- Auth: HTTP bearer
Query parameters
Exact id, a unique id prefix, or a title. Switches the route into resolution mode.
Full-text match across title, prompt and content. Repeatable. Ignored with selector.
Only this Project (handle or id), or _ for the sessions with no Project. A handle from another org returns no rows.
Only sessions started from this surface (Session.source.kind).
Only sessions this API key started (key_…), through the API or MCP.
Harness as dispatched, e.g. claude or codex.
Every session today is cloud; local returns an empty list.
Launch-boundary managed harnesses.
owner/name.
One status, or several separated by commas (failed,cancelled). A key sends one.
Lower time bound. Relative (2h, 7d) or ISO 8601.
Upper time bound. Relative (2h, 7d) or ISO 8601.
When true, return only count and an empty sessions.
Max rows to return.
Opaque pagination cursor from a previous response's next_cursor.
Response
The sessions; for a signed-in session, the matching sessions or the one a selector resolved to.
Changes
No recorded changes to this operation across all 3 revisions of this API.