Update a Room folder
PATCH
Renames, moves (parent_folder_id; null for the top) or reorders a folder: Can edit. access_mode (inherit or restricted) changes who can see it: Full access on the Room only. Moving it out of a restricted folder shows it to more people, so that is Full access only too.
header
AuthorizationBearer <token>A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.
room_folder_id*stringMatch
^rfd_[0-7][0-9A-HJKMNP-TV-Z]{25}$SMB-Workspace-Id*stringWorkspace where this operation runs. Required for user tokens and Workspace API keys.
Format
uuidIdempotency-Key*stringLength
8 <= length <= 200application/json- body
name?stringMatch
^[^\u0000-\u001f\u007f]+$Length
1 <= length <= 200parent_folder_id?|nullposition?integerRange
0 <= value <= 999999access_mode?stringValue in
"inherit""restricted"Successful authorized response.
application/json- response
room_folder_id*stringMatch
^rfd_[0-7][0-9A-HJKMNP-TV-Z]{25}$room_id*stringMatch
^rom_[0-7][0-9A-HJKMNP-TV-Z]{25}$parent_folder_id*|The folder it is in; null at the top (or when you can't open the folder above).
name*stringposition*integerRange
-9007199254740991 <= value <= 9007199254740991access_mode*AccessModeinherit: everyone who can see the folder above (or the Room). restricted: only people added to it.
Value in
"inherit""restricted"item_count*ItemCountFolders and files inside it that you can see.
Range
-9007199254740991 <= value <= 9007199254740991access_level*stringYour access on this folder.
Value in
"view""edit""full_access"created_at*stringupdated_at*stringrequest_id*stringcurl -X PATCH 'https://example.com/v1/room-folders/string' \ -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'Idempotency-Key: stringst' \ -H 'Content-Type: application/json' \ -d '{}'{ "room_folder_id": "string", "room_id": "string", "parent_folder_id": "string", "name": "string", "position": -9007199254740991, "access_mode": "inherit", "item_count": -9007199254740991, "access_level": "view", "created_at": "string", "updated_at": "string", "request_id": "string"}