Tokens API v1 - PUT an existing token
Updates the specified Dynatrace API authentication token. You can:
- Change the token name.
- Add or remove token permissions.
- Revoke the token. A revoked token still exists in the environment, but it can't be used.
The request consumes an application/json
payload.
PUT |
|
Authentication
To execute this request, you need the Token management (TenantTokenManagement
) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
id | string |
The ID of the token to be updated. You can't update the token you're using for authentication of the request. |
path | required |
body | UpdateToken |
The JSON body of the request. Contains updated parameters of the token. |
body | optional |
Body format
The UpdateToken object
Element | Type | Description | Required |
---|---|---|---|
revoked | boolean |
The token is revoked ( |
optional |
name | string |
The name of the token. |
optional |
scopes | string[] |
The list of permissions assigned to the token. Apart from the new permissions, you need to submit the existing permissions you want to keep, too. Any existing permission, missing in the payload, is revoked.
|
optional |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request. See the Example expandable section for working sample request.
{
"revoked": true,
"name": "string",
"scopes": [
"string"
]
}
Response
Response codes
Code | Description |
---|---|
204 | Success. The token has been updated. |
400 | Failed. You can't update the token you're using for authentication of the request. |
404 | Failed. The requested token has not been found. |
Response body
A successful request doesn't return any content.
Example
In this example, the request queries the metadata of the admin token, which has the ID of d5836312-5790-4e80-afcf-09971954c3ea. It assigns two new permissions: Real user monitoring JavaScript tag management and ActiveGate certificate management. The name and validity of the token remain intact. The response code of 204 indicates that the update was successful.
The token, as displayed in the Dynatrace interface, has the following settings before the edit:
The API token is passed in the Authorization header.
You can download or copy the example request body to try it out on your own.
Curl
curl -X PUT \
https://mySampleEnv.live.dynatrace.com/api/v1/tokens/d5836312-5790-4e80-afcf-09971954c3ea \
-H 'Authorization: Api-Token abcdefjhij1234567890' \
-H 'Content-Type: application/json' \
-d '{
"scopes": [
"ExternalSyntheticIntegration",
"DataPrivacy",
"WriteConfig",
"DssFileManagement",
"LogExport",
"DTAQLAccess",
"ReadConfig",
"CaptureRequestData",
"ReadSyntheticData",
"DataExport",
"UserSessionAnonymization",
"MaintenanceWindows",
"LogImport",
"TenantTokenManagement",
"ActiveGateCertManagement",
"RumJavaScriptTagManagement"
]
}
'
Request URL
https://mySampleEnv.live.dynatrace.com/api/v1/tokens/d5836312-5790-4e80-afcf-09971954c3ea
Request body
api-examples/env/token/put-token.json
{
"scopes": [
"ExternalSyntheticIntegration",
"DataPrivacy",
"WriteConfig",
"DssFileManagement",
"LogExport",
"DTAQLAccess",
"ReadConfig",
"CaptureRequestData",
"ReadSyntheticData",
"DataExport",
"UserSessionAnonymization",
"MaintenanceWindows",
"LogImport",
"TenantTokenManagement",
"ActiveGateCertManagement",
"RumJavaScriptTagManagement"
]
}
Response code
204
Result
The updated token, as displayed in the Dynatrace interface, has the following parameters: