Transfer document ownership in Dynatrace with the Document API by setting a new owner, and the previous owner loses access to the document.
| POST | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/document/v1/documents/{id}:transfer-owner |
You provide the document id in the path and the newOwnerId in the request body. The operation transfers ownership to the new user, returns no content, and only the current document owner can perform it.
To execute this request, you need a platform token or OAuth access token with document:documents:write scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| body | Transfer | Input required to transfer document ownership. | body | Optional |
TransferOwner objectInput required to transfer document ownership.
| Element | Type | Description | Required |
|---|---|---|---|
| newOwnerId | string | SSO id of the new owner. | Required |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{"newOwnerId": "string"}
| Code | Description |
|---|---|
| 204 | Ownership has been transferred successfully. |
| 400 | - |
| 403 | - |
| 404 | - |
| 409 | - |
| 500 | - |
| 503 | - |
| default | - |