Set who can see it
Sets who can see a folder, Room file, File, task or goal: only_me (whoever made it), people (only those added), workspace (my workspace), room (everyone in this Room) or inherit. A folder is room/inherit (open), people or workspace (restricted): Full access only. A File is only_me, people or workspace. For workspace, pass workspace_id when you are in more than one Workspace; it must be one you are in.
AuthorizationBearer <token>A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.
SMB-Workspace-Id*stringWorkspace where this operation runs. Required for user tokens and Workspace API keys.
uuidapplication/json- body
object_type*string"room_folder""room_file""file""task""goal"object_id*stringIts ID: rom_, rfd_, rfl_, fil_, tsk_ or gol_.
1 <= length <= 40visibility*VisibilityWho can see it: only_me, people (only those added), workspace (my workspace), room (everyone in this Room), inherit (follow the folder above or the Room).
"only_me""people""workspace""room""inherit"workspace_id?stringFor workspace: which of your Workspaces. Without it, the request's Workspace if you are in it, else your only one.
^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$Successful authorized response.
application/json- response
object*visibility*VisibilityWho can see it: only_me, people (only those added), workspace (my workspace), room (everyone in this Room), inherit (follow the folder above or the Room).
"only_me""people""workspace""room""inherit"access_mode?string"inherit""restricted"can_manage*booleanWhether you can change who sees it (grants list only then).
mine?booleanA File: whether you made it (only its maker picks only_me).
grants*array<>request_id*stringcurl -X PATCH 'https://example.com/v1/access/visibility' \ -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'Content-Type: application/json' \ -d '{ "object_type": "room_folder", "object_id": "string", "visibility": "only_me"}'{ "object": { "type": "room", "id": "string", "name": "string", "access_level": "view" }, "visibility": "only_me", "access_mode": "inherit", "can_manage": true, "mine": true, "grants": [ { "subject": { "type": "string", "id": "string", "label": "string", "email": "string" }, "access_level": "view", "source_type": "string", "inherited_from": { "type": "room_folder", "id": "string", "name": "string" }, "created_at": "string" } ], "request_id": "string"}