Skip to content

Latest commit

 

History

History
148 lines (94 loc) · 4.31 KB

usercollaborations.md

File metadata and controls

148 lines (94 loc) · 4.31 KB

UserCollaborationsManager

Get collaboration

Retrieves a single collaboration.

This operation is performed by calling function getCollaborationById.

See the endpoint docs at API Reference.

client.getUserCollaborations().getCollaborationById(collaborationId)

Arguments

  • collaborationId String
    • The ID of the collaboration Example: "1234"
  • queryParams GetCollaborationByIdQueryParams
    • Query parameters of getCollaborationById method
  • headers GetCollaborationByIdHeaders
    • Headers of getCollaborationById method

Returns

This function returns a value of type Collaboration.

Returns a collaboration object.

Update collaboration

Updates a collaboration. Can be used to change the owner of an item, or to accept collaboration invites.

This operation is performed by calling function updateCollaborationById.

See the endpoint docs at API Reference.

client.getUserCollaborations().updateCollaborationById(collaborationId, new UpdateCollaborationByIdRequestBody(UpdateCollaborationByIdRequestBodyRoleField.VIEWER))

Arguments

  • collaborationId String
    • The ID of the collaboration Example: "1234"
  • requestBody UpdateCollaborationByIdRequestBody
    • Request body of updateCollaborationById method
  • headers UpdateCollaborationByIdHeaders
    • Headers of updateCollaborationById method

Returns

This function returns a value of type Collaboration.

Returns an updated collaboration object unless the owner has changed.If the role is changed to owner, the collaboration is deleted and a new collaboration is created. The previous owner of the old collaboration will be a co-owner on the new collaboration.

Remove collaboration

Deletes a single collaboration.

This operation is performed by calling function deleteCollaborationById.

See the endpoint docs at API Reference.

client.getUserCollaborations().deleteCollaborationById(collaborationId)

Arguments

  • collaborationId String
    • The ID of the collaboration Example: "1234"
  • headers DeleteCollaborationByIdHeaders
    • Headers of deleteCollaborationById method

Returns

This function returns a value of type void.

A blank response is returned if the collaboration was successfully deleted.

Create collaboration

Adds a collaboration for a single user or a single group to a file or folder.

Collaborations can be created using email address, user IDs, or a group IDs.

If a collaboration is being created with a group, access to this endpoint is dependent on the group's ability to be invited.

If collaboration is in pending status, the following fields are redacted:

  • login and name are hidden if a collaboration was created using user_id,
  • name is hidden if a collaboration was created using login.

This operation is performed by calling function createCollaboration.

See the endpoint docs at API Reference.

client.getUserCollaborations().createCollaboration(new CreateCollaborationRequestBody(new CreateCollaborationRequestBodyItemField.CreateCollaborationRequestBodyItemFieldBuilder().type(CreateCollaborationRequestBodyItemTypeField.FOLDER).id(folder.getId()).build(), new CreateCollaborationRequestBodyAccessibleByField.CreateCollaborationRequestBodyAccessibleByFieldBuilder(CreateCollaborationRequestBodyAccessibleByTypeField.USER).id(user.getId()).build(), CreateCollaborationRequestBodyRoleField.EDITOR))

Arguments

  • requestBody CreateCollaborationRequestBody
    • Request body of createCollaboration method
  • queryParams CreateCollaborationQueryParams
    • Query parameters of createCollaboration method
  • headers CreateCollaborationHeaders
    • Headers of createCollaboration method

Returns

This function returns a value of type Collaboration.

Returns a new collaboration object.