SMBBETA

List Room Files

Last updated Oct 10, 2026View as MarkdownAgent setup / MCP
GET
/v1/rooms/{room_id}/files

Lists the Files visible in one Room, each at the version the Room shows (the File's newest ready version).

Authorization

AuthorizationBearer <token>

Signed-in user's Supabase access token. Workspace-scoped operations also require SMB-Workspace-Id.

In: header

Path Parameters

room_id*string

Stable Room ID.

Match^rom_[0-7][0-9A-HJKMNP-TV-Z]{25}$

Query Parameters

status?string

Value in

  • "pending"
  • "active"
  • "archived"
after?string

Room File cursor from a previous page.

Match^rfl_[0-7][0-9A-HJKMNP-TV-Z]{25}$
limit?integer
Range1 <= value <= 100
Default20

Header Parameters

SMB-Workspace-Id*string

Workspace where this operation runs. Required for user tokens and Workspace API keys.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/rooms/string/files" \  -H "SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "files": [    {      "room_file_id": "string",      "room_id": "string",      "file": {        "file_id": "string",        "business_id": "string",        "name": "string",        "description": "string",        "classification": "financial",        "tags": [          "string"        ],        "origin": "upload",        "lifecycle": "active",        "current_version": {          "file_version_id": "string",          "version_number": 1,          "content_type": "string",          "size_bytes": 1,          "sha256": "string",          "processing_status": "pending_upload",          "processing_error": "string",          "summary": "string",          "created_at": "2019-08-24T14:15:22Z",          "ready_at": "2019-08-24T14:15:22Z"        },        "revision": 1,        "created_at": "2019-08-24T14:15:22Z",        "updated_at": "2019-08-24T14:15:22Z",        "archived_at": "2019-08-24T14:15:22Z",        "access_level": "view"      },      "file_version_id": "string",      "access_mode": "inherit_room",      "status": "pending",      "revision": 1,      "attached_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "archived_at": "2019-08-24T14:15:22Z",      "access_level": "view"    }  ],  "has_more": true,  "next_cursor": "string",  "request_id": "string"}