Beta

List Room file suggestions

Last updated Nov 19, 2026View as MarkdownAgent setup / MCP
GET
/v1/rooms/{room_id}/file-suggestions

SMB's open suggestions for where files in a Room belong, for the files you can edit: the folder (or a new folder to make) and how sure SMB is. With drop_batch_id, only the files uploaded together. Nothing moves: accept one with accept_room_file_suggestion (or move the file yourself with move_room_file), or say no with dismiss_room_file_suggestion. A Room can turn suggestions off.

Authorization

headerAuthorizationBearer <token>

A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.

Path Parameters

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

Query Parameters

drop_batch_id?string

Only the files uploaded together (the drop_batch_id on a suggestion).

Length1 <= length <= 100

Header Parameters

SMB-Workspace-Id*string

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

Formatuuid

Response Body

Successful authorized response.

application/json
  1. response
suggestions*array<>
request_id*string
curl -X GET 'https://example.com/v1/rooms/string/file-suggestions' \  -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08'
{  "suggestions": [    {      "suggestion_id": "string",      "state": "suggested",      "confidence": 0,      "needs_pick": true,      "folder_id": "string",      "parent_folder_id": "string",      "new_folder_path": [        "string"      ],      "path": [        "string"      ],      "reason": "string",      "drop_batch_id": "string",      "room_file_id": "string",      "file_name": "string"    }  ],  "request_id": "string"}