List sessions
Returns Sessions newest first, cursor-paginated. By default, status=active hides archived Sessions; status accepts active, archived, or all. origin accepts ui, external, external:cli|mcp|api, or comma-separated values. Follow-up execution Attempts update their Session and never appear as additional list items. A list item reports the same status and outcome as Retrieve a session; its result is the text summary, and Retrieve a session returns a structured result. Responses carry a weak ETag; send it as If-None-Match to receive 304 Not Modified while the page is unchanged. A 304 may repeat usage counters (usage, context, cost_usd, duration_ms) up to 10 seconds old.
<sub>Scope: sessions:read</sub>
Request
- Base URL: https://api.reasonmachines.com
- URL: https://api.reasonmachines.com/v3/organizations/{orgId}/sessions
- Auth: HTTP bearer
Query parameters
Session status filter: active (default), archived, or all.
Comma-separated origin filter: ui, external, or external:cli|external:mcp|external:api. external matches all external sources.
Compatibility filter: exclude active, only archived, include both. Defaults to status=active.
Case-insensitive literal search of session display-title fields, not transcript contents. Minimum 3 characters. Search pages are capped at 24 items; follow end_cursor for more.
Filter sessions by an accessible existing Project in this Workspace.
Page size (default 50, max 200).
Alias for first (page size).
Cursor from the previous page's end_cursor.
Response
A page of sessions.
Changes
No recorded changes to this operation across all 1 revision of this API.