Accept a Room file suggestion
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.
AuthorizationBearer <token>A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.
suggestion_id*string^rsg_[0-7][0-9A-HJKMNP-TV-Z]{25}$SMB-Workspace-Id*stringWorkspace where this operation runs. Required for user tokens and Workspace API keys.
uuidIdempotency-Key*string8 <= length <= 200application/json- body
Successful authorized response.
application/json- response
room_file_id*stringStable Room File attachment ID.
^rfl_[0-7][0-9A-HJKMNP-TV-Z]{25}$room_id*stringRoom containing this attachment.
^rom_[0-7][0-9A-HJKMNP-TV-Z]{25}$file*file_version_id*FileVersionIdThe File version this Room shows: its newest ready version, which follows new uploads.
^fvr_[0-7][0-9A-HJKMNP-TV-Z]{25}$access_mode*string"inherit_room""restricted""private"status*string"pending""active""archived"revision*integer1 <= valueattached_at*smb_v0_operations_get_business_request.__local.Timestampdate-timeupdated_at*smb_v0_operations_get_business_request.__local.Timestampdate-timearchived_at*|date-timeaccess_level*string"view""edit""full_access"folder_id?|The Room folder it is in; null at the Room's top level.
^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.
length <= 300read_state?ReadStatepending until SMB has read the file, so a name that says little can show as being named.
"pending""done"suggestion?|SMB's open suggestion for where it goes, for people who can edit it; null when there is none.
request_id*stringcurl -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"}