Share it
Shares a Room, folder, File, task or goal with someone, or changes their level. A folder or File shared with someone outside gives them just that. A Room is shared by email (it sends an invitation). Needs Full access (a task or goal: also whoever made it). Requires explicit user intent.
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.
uuidIdempotency-Key*string8 <= length <= 200application/json- body
object_type*ObjectTypeWhat 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 <= 40to*|||Who: a person by email or account, a Workspace you are in, or (tasks and goals) everyone in their Room.
access_level*string"view""edit""full_access"The existing resource or idempotent replay was returned.
application/json- response
subject*access_level*string"view""edit""full_access"source_type*SourceTypeWhere it comes from: given here (api, participant, invite), inherited from a folder above, or room (everyone who can open the Room).
inherited_from?created_at*stringrequest_id*stringcurl -X POST 'https://example.com/v1/access' \ -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'Idempotency-Key: stringst' \ -H 'Content-Type: application/json' \ -d '{ "object_type": "room", "object_id": "string", "to": { "type": "person", "email": "user@example.com" }, "access_level": "view"}'{ "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"}