Beta

Accept a Room file suggestion

Last updated Nov 19, 2026View as MarkdownAgent setup / MCP
POST
/v1/room-file-suggestions/{suggestion_id}/accept

Does what SMB suggested for a Room file: finds or makes the folder (a folder that already exists with that name under the same parent is reused, so two files accepted into the same new folder share it) and moves the file there, in one step. If the move fails nothing is left behind. Needs Can edit on the file. Accepting one that is already accepted changes nothing. Returns the Room file.

Authorization

headerAuthorizationBearer <token>

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

Path Parameters

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

Header Parameters

SMB-Workspace-Id*string

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

Formatuuid
Idempotency-Key*string
Length8 <= length <= 200

Request Body

application/json
  1. body

Response Body

Successful authorized response.

application/json
  1. response
room_file_id*string

Stable Room File attachment ID.

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

Room containing this attachment.

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

The File version this Room shows: its newest ready version, which follows new uploads.

Match^fvr_[0-7][0-9A-HJKMNP-TV-Z]{25}$
access_mode*string
Value in"inherit_room""restricted""private"
status*string
Value in"pending""active""archived"
revision*integer
Range1 <= value
attached_at*smb_v0_operations_get_business_request.__local.Timestamp
Formatdate-time
updated_at*smb_v0_operations_get_business_request.__local.Timestamp
Formatdate-time
archived_at*|
Formatdate-time
access_level*string
Value in"view""edit""full_access"
folder_id?|

The Room folder it is in; null at the Room's top level.

Match^rfd_[0-7][0-9A-HJKMNP-TV-Z]{25}$
original_name?|

The name it was uploaded with, when SMB or a person has renamed it since; null otherwise.

Lengthlength <= 300
read_state?ReadState

pending until SMB has read the file, so a name that says little can show as being named.

Value in"pending""done"
suggestion?|

SMB's open suggestion for where it goes, for people who can edit it; null when there is none.

request_id*string
curl -X POST 'https://example.com/v1/room-file-suggestions/string/accept' \  -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Idempotency-Key: stringst' \  -H 'Content-Type: application/json' \  -d '{}'
{  "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_by": {        "type": "person",        "user_id": "string",        "name": "string",        "via": null      },      "created_at": "2019-08-24T14:15:22Z",      "ready_at": "2019-08-24T14:15:22Z",      "protection": {},      "redacted_from": "string",      "redacted_copy": "string"    },    "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",  "folder_id": "string",  "original_name": "string",  "read_state": "pending",  "suggestion": {    "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"  },  "request_id": "string"}