Sign in

v1

latestOpenAPI 3.1.02026-07-2618690613.4 KB
Documents

Transfer document ownership

Transfer ownership of a document to another user in the organization.

To successfully transfer a document:

  • The user performing the transfer must have MANAGER permissions or higher on the document
  • The new owner must be a member of the organization AND have explicit access to the document

Upon success, the following occurs:

  • Ownership of the document is updated to the new owner
  • The previous owner is granted MANAGER permissions on the document
  • Explicit permits for the new owner are revoked, as they now have owner access
  • Content search index is updated

Note: Transferring to the current owner is a no-op and returns success.

put/v1/documents/{documentId}/transfer-ownership

Path parameters

documentIdstring required

The ID of the document to transfer. To retrieve the ID, navigate to File > Document settings in the document and then click Settings. The Identifier field contains the document ID.

Request body

userIdstring required

The membership ID of the user to transfer ownership to. This must be a valid organization member who has explicit permission on the document.

Response

Document ownership transferred successfully.

Note: This response is also returned when transferring to the current owner.

successboolean

Example response

{
  "success": true
}