# List files

GET /v1/sessions/{session_id}/files: List the files in the session with their status.

GET<code>/v1/sessions/&#123;session_id&#125;/files</code>

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](/guides/run/authenticate-your-backend); 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

```bash
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

```json title="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"
    }
  ]
}
```