Who can see it
Who can see a Room, folder, File, task or goal, and the who-can-see choice. People who manage it (Full access, or whoever made a task or goal) get the list, each with where it comes from: given here, inherited from a folder above, or the Room.
AuthorizationBearer <token>A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.
object_type*stringWhat to share: a Room, a folder, a Room file, a File, a task or a goal.
"room""room_folder""room_file""file""task""goal"object_id*stringIts ID: rom_, rfd_, rfl_, fil_, tsk_ or gol_.
1 <= length <= 40SMB-Workspace-Id*stringWorkspace where this operation runs. Required for user tokens and Workspace API keys.
uuidSuccessful 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 GET 'https://example.com/v1/access?object_type=room&object_id=string' \ -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "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"}