Beta

Move a Room file

Last updated Nov 19, 2026View as MarkdownAgent setup / MCP
POST
/v1/room-files/{room_file_id}/move

Puts a Room file in a folder, or at the Room's top level (folder_id null). Needs Can edit on the file and the folder; moving it out of a restricted folder is Full access only.

Authorization

headerAuthorizationBearer <token>

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

Path Parameters

room_file_id*string
Match^rfl_[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
folder_id*|null

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-files/string/move' \  -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Idempotency-Key: stringst' \  -H 'Content-Type: application/json' \  -d '{  "folder_id": "string"}'
{  "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"}