v1

latestOpenAPI 3.0.3Lucid2026-07-14155181312.3 KB
Documents Collaboration

Create/Update Document User Collaborator

Updates the collaborator role for a user on a document. If the user did not previously have access to the document, they will be granted access and a new collaborator record will be created.

put/v1/documents/{id}/shares/users/{userId}

Path parameters

idstring uuid required

ID of the document.

userIdnumber required

ID of the user to retrieve collaborator settings for.

Request body

role'editandshare' | 'edit' | 'comment' | 'view'

The Collaborator Role to assign to the user for this document.

Example request

{
  "role": "comment"
}

Response

OK when updating an existing Document User Collaborator. Contains the updated Document User Collaborator Resource.

documentIdstring uuid required

Document ID

userIdinteger required

User ID

role'owner' | 'editandshare' | 'edit' | 'comment' | 'view' required

The Collaborator Role on the document or folder

createdstring date-time required

Date and time when the collaboration was created