Beta

Who can see it

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

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.

Authorization

headerAuthorizationBearer <token>

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

Query Parameters

object_type*string

What to share: a Room, a folder, a Room file, a File, a task or a goal.

Value in"room""room_folder""room_file""file""task""goal"
object_id*string

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

Length1 <= length <= 40

Header Parameters

SMB-Workspace-Id*string

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

Formatuuid

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 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"}