List Session Files

GET/v1/agents/sessions/{session_id}/files

List attachments with offset pagination. limit must be 1-100.

Path parameters

stringsession_idrequired

Session ID (ses_ prefix).

Query parameters

Optional<integer>limit

Page size up to 100; values above 100 return 400, and 0 or non-numeric values fall back to 20.

Default: 20

Optional<integer>offset

Number of records to skip.

Default: 0

curl -X GET "https://api.sandbase.ai/v1/agents/sessions/ses_5b0e7c3a-91d2-5f4e-8a6b-2c9d4e1f7a83/files?limit=20" \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response200 OK

{
  "data": [
    {
      "id": "fil_6d8f0a2c-4e6b-5d8f-a1c3-5e7a9c1e3b72",
      "session_id": "ses_5b0e7c3a-91d2-5f4e-8a6b-2c9d4e1f7a83",
      "name": "q3-report.pdf",
      "mime_type": "application/pdf",
      "size_bytes": 482113,
      "status": "ready",
      "created_at": "2026-10-06T08:10:00Z",
      "updated_at": "2026-10-06T08:10:02Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}