Sessions

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>

get/v3/organizations/{orgId}/sessions

Request

  • Base URL: https://api.reasonmachines.com
  • URL: https://api.reasonmachines.com/v3/organizations/{orgId}/sessions
  • Auth: HTTP bearer

Query parameters

status'active' | 'archived' | 'all'

Session status filter: active (default), archived, or all.

originstring

Comma-separated origin filter: ui, external, or external:cli|external:mcp|external:api. external matches all external sources.

archived'exclude' | 'only' | 'include'

Compatibility filter: exclude active, only archived, include both. Defaults to status=active.

searchstring

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.

project_idstring uuid

Filter sessions by an accessible existing Project in this Workspace.

firstinteger

Page size (default 50, max 200).

limitinteger

Alias for first (page size).

afterstring

Cursor from the previous page's end_cursor.

Response

A page of sessions.

end_cursorstring nullable
has_next_pageboolean

Changes

No recorded changes to this operation across all 1 revision of this API.