List Room file suggestions
GET
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.
header
AuthorizationBearer <token>A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.
room_id*stringMatch
^rom_[0-7][0-9A-HJKMNP-TV-Z]{25}$drop_batch_id?stringOnly the files uploaded together (the drop_batch_id on a suggestion).
Length
1 <= length <= 100SMB-Workspace-Id*stringWorkspace where this operation runs. Required for user tokens and Workspace API keys.
Format
uuidSuccessful authorized response.
application/json- response
suggestions*array<>request_id*stringcurl -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"}