Create/Update Folder User Collaborator

put

https://api.lucid.co/folders/{id}/shares/users/{userId}

Update the collaborator role for a user.

If the user did not have access to the folder before, they will be granted access and a new Folder User Collaborator Resource will be created.

📘
Collaborators cannot be given the role owner, and the role of the folder's owner can not be modified.

📘
See the Collaborator section overview for details about how folder and document access to groups and users are inherited and interact with each other to become a user's effective access to a folder or document.

Valid Authentication Methods

API Key Grants:

FolderEdit

OAuth 2.0 User Token Scopes:

folder

Responses

400

Bad Request when trying to add or update a Folder User Collaborator to have the "owner" role.

403

Forbidden if the token does not have permission to the folder, or if the folder has been deleted or does not exist.

Collaborators cannot be given the role owner, and the role of the folder's owner can not be modified.

See the Collaborator section overview for details about how folder and document access to groups and users are inherited and interact with each other to become a user's effective access to a folder or document.

Valid Authentication Methods

API Key Grants:

OAuth 2.0 User Token Scopes:

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

201Created when creating a new Folder User Collaborator. Contains the new Folder User Collaborator Resource.