List sessions

GET/v1/sessions

List the caller’s sessions in the selected tenant. include_all_users=true returns the tenant-wide view permitted by the caller’s role, inside the same tenant boundary.

Generated from the Platform API specification on 2026-09-04.

Query parameters

Parameter	Type	Description
agent	string	Only sessions of this agent.
status	string	Only sessions in this status.
limit	integer	Maximum number of sessions to return.
parent_session_id	string	Only sessions forked from this parent.
include_all_users	boolean	Include sessions owned by other users the caller’s role may see.

Headers

Header	Required	Description
Authorization	yes	Bearer plus a short-lived OAuth access token issued for the Tanomis API audience. Backends obtain tokens with an organization automation client; the CLI’s human login is not an application credential.
X-Organization-ID	yes	The organization_id from the workspace projection you selected in GET /v1/me/workspaces.
X-Workspace-Tenant-ID	yes	The nested tenant_id from the same projection. A header cannot widen what the token grants. Some single-workspace or self-hosted environments take X-Tenant-ID instead, as supplied by their administrator.

Responses

Status	Meaning
200	Sessions, newest first.

Request

cURL

Terminal

curl -X GET "https://api.tanomis.com/v1/sessions" \
  -H "Authorization: Bearer $TANOMIS_TOKEN" \
  -H "X-Organization-ID: $TANOMIS_ORG" \
  -H "X-Workspace-Tenant-ID: $TANOMIS_WORKSPACE"

Python

import httpx

response = httpx.get(
    f"https://api.tanomis.com/v1/sessions",
    headers={
        "Authorization": f"Bearer {token}",
        "X-Organization-ID": organization_id,
        "X-Workspace-Tenant-ID": tenant_id,
    },
)
response.raise_for_status()
result = response.json()

TypeScript

const response = await fetch(`https://api.tanomis.com/v1/sessions`, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`,
    "X-Organization-ID": organizationId,
    "X-Workspace-Tenant-ID": tenantId,
  },
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const result = await response.json();

Response

200 OK

{
  "sessions": [
    {
      "id": "ses_7d4f9c",
      "agent_name": "support-copilot",
      "version": "0.4.0",
      "status": "ready",
      "created_at": "2026-09-02T11:42:18Z",
      "awaiting_input": false
    }
  ]
}