Update document permission

Updates the permission assignment for a user or group within the document, modifying their role and access level.

PATCH/organizations/{organizationName}/workspaces/{workspaceName}/documents/{documentPath}/permissions/{userGroupId}

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

organizationName*string

The unique identifier of the organization

Match^[a-zA-Z0-9_ -]+$

workspaceName*string

The unique identifier of the workspace

Match^(?!.*\*)(?!.*[/]).{1,63}$

documentPath*string

The path to the document within the workspace

Match^(?!.*\.\.)[a-zA-Z0-9_/. \-&:,'+?!()$^–—]+$

Lengthlength <= 255

userGroupId*string

The unique identifier of the user or group

Match^(user:[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}|group:[a-zA-Z0-9._-]+)$

Request Body

application/json

Represents a permission assignment for a user or group within a document

userGroupId?UserGroupId

A resource identifier that uniquely identifies either a user or a group within the system. This identifier is used throughout the API for permission management and access control.

Format:

For users: user:{email} or user:{userId}
For groups: group:{groupName}

Match^(user:[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}|group:[a-zA-Z0-9._-]+)$

permission?string

The role/permission level granted to the user or group

Value in

"editor"
"viewer"

inheritedPermission?string

The permission level inherited from parent workspace

Value in

"manager"
"viewer"

message?string

Optional message or note about the permission assignment

createdAt?string

ISO 8601 timestamp indicating when the permission was created

Formatdate-time

updatedAt?string

ISO 8601 timestamp indicating when the permission was last modified

Formatdate-time

Response Body

`application/json`

curl --request PATCH \  --url 'https://example.com/organizations/string/workspaces/string/documents/string/permissions/string' \  --header 'Authorization: Bearer <token>' \  --header 'Content-Type: application/json' \  --data '{}'

{  "userGroupId": "string",  "permission": "editor",  "inheritedPermission": "manager",  "message": "string",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}

Update document permission

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`