Beta

Set who can see it

Last updated Nov 19, 2026View as MarkdownAgent setup / MCP
PATCH
/v1/access/visibility

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.

Authorization

headerAuthorizationBearer <token>

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

Header Parameters

SMB-Workspace-Id*string

Workspace where this operation runs. Required for user tokens and Workspace API keys.

Formatuuid

Request Body

application/json
  1. body
object_type*string
Value in"room_folder""room_file""file""task""goal"
object_id*string

Its ID: rom_, rfd_, rfl_, fil_, tsk_ or gol_.

Length1 <= length <= 40
visibility*Visibility

Who 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).

Value in"only_me""people""workspace""room""inherit"
workspace_id?string

For workspace: which of your Workspaces. Without it, the request's Workspace if you are in it, else your only one.

Match^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$

Response Body

Successful authorized response.

application/json
  1. response
object*
visibility*Visibility

Who 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).

Value in"only_me""people""workspace""room""inherit"
access_mode?string
Value in"inherit""restricted"
can_manage*boolean

Whether you can change who sees it (grants list only then).

mine?boolean

A File: whether you made it (only its maker picks only_me).

grants*array<>
request_id*string
curl -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"}