List files

GET/v1/sessions/{session_id}/files

List the files in the session with their status. Available even when the agent version lacks file support, so existing files can be inspected.

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

Path parameters

Parameter	Type	Description
session_id	string	The session, as returned by Create a session.

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	The session’s files.

Request

cURL

Terminal

curl -X GET "https://api.tanomis.com/v1/sessions/ses_7d4f9c/files" \
  -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/{session_id}/files",
    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/${sessionId}/files`, {
  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

{
  "files": [
    {
      "id": "file_b172c9",
      "filename": "case-summary.pdf",
      "media_type": "application/pdf",
      "size_bytes": 48213,
      "status": "ready",
      "created_at": "2026-09-02T11:45:00Z"
    }
  ]
}