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
MANAGERpermissions 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
MANAGERpermissions 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.
Authorizations
Can be either an Organization API Key or Personal Access Token (PAT).
Include in the Authorization header as: Bearer YOUR_TOKEN
Path Parameters
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.
Body
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.
true