List Sessions With Agent Info
Session records merged with their agent-connection metadata (CLO-434).
Joins session_records to the agent-connections registry on
session_id so the cloud UI can group/filter usage by client
(Claude Code, Codex, Slack, MCP, …) without a second round
trip. When no registered connection matches a session, the
agent type is inferred from the session_id/origin_function
prefix convention (e.g. claude-code-..., codex-...).
Memory sources are intentionally omitted — per-agent dataset attribution isn’t reliably populated yet.
Response envelope mirrors GET /api/v1/sessions, with each
session additionally carrying agent_type, agent_source,
agent_session_name, and origin_function.
Query Parameters
- descending (bool): Sort in descending order. Defaults to True.
- limit (int): Page size (max 500). Defaults to 50.
- offset (int): Rows to skip for pagination. Defaults to 0.
- order_by (str): Column to sort by. Defaults to ‘last_activity_at’.
- range (Literal[‘24h’, ‘7d’, ‘30d’, ‘all’]): Time window filtered on last_activity_at: 24h, 7d, 30d, or all. Defaults to ‘30d’.
- status (Optional[str]): Effective-status filter: running, completed, failed, or abandoned.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Time window filtered on last_activity_at: 24h, 7d, 30d, or all.
24h, 7d, 30d, all "30d"
Effective-status filter: running, completed, failed, or abandoned.
Page size (max 500).
1 <= x <= 500Rows to skip for pagination.
x >= 0Response
Successful Response