Personal access token
Normally, access tokens require admin rights to generate. With personal access tokens, however, you can generate a token for API usage without admin rights. Available scopes are bound to your permissions, meaning that you can only use the API counterparts of features you're already authorized to use. You're also limited to the data from management zones you have access to.
A personal access token is bound to you. You can't generate a personal access token for another user.
Enable personal access tokens
Admin rights are required to enable this feature. After it's enabled, any user can generate a personal access token.
To enable personal access tokens
- In the Dynatrace menu, go to Settings and select Integration > Access tokens.
- Turn on Enable personal access tokens.
Generate personal access tokens
To generate a personal access token
- Open the user menu in the upper-right corner of the Dynatrace web UI and select Personal access tokens.
- Select Generate new token.
- Enter a name for your token.
Dynatrace doesn't enforce unique token names. You can create multiple tokens with the same name. Be sure to provide a meaningful name for each token you generate. Proper naming helps you to efficiently manage your tokens and perhaps delete them when they're no longer needed. - Select the required scopes for the token.
- Select Generate token.
- Copy the generated token to the clipboard. Store the token in a password manager for future use.
You can only access your token once upon creation. You can't reveal it afterward.
Available scopes
Name | API value | Description |
---|---|---|
Read ActiveGates |
| Grants access to GET requests of the ActiveGates API. |
Write ActiveGates |
| Grants access to POST and DELETE requests of the ActiveGates API. |
Read API tokens |
| Grants access to GET requests of the Access tokens API. |
Write API tokens |
| Grants access to POST, PUT, and DELETE requests of the Access tokens API. |
Read attacks |
| Grants access to GET requests of the Attacks API and attack-related schemas in the Settings API. |
Read entities |
| Grants access to GET requests of the Monitored entities and Custom tags APIs. |
Write entities |
| Grants access to POST, PUT, and DELETE requests of the Monitored entities and Custom tags APIs. |
Ingest events |
| Grants access to POST request of the Events API v2. |
Read events |
| Grants access to GET requests of the Events API v2. |
Read extensions monitoring configuration |
| Grants access to GET requests from the Extensions monitoring configuration section of the Extensions 2.0 API. |
Write extensions monitoring configuration |
| Grants access to POST, PUT, and DELETE requests from the Extensions monitoring configuration section of the Extensions 2.0 API. |
Read extensions |
| Grants access to GET requests from the Extensions section of the Extensions 2.0 API. |
Write extensions |
| Grants access to POST, PUT, and DELETE requests from the Extensions section of the Extensions 2.0 API. |
Install and update Hub items |
| Grants permission to install and update extensions via the Hub items API. |
Read Hub-related data |
| Grants access to GET requests of the Hub items API. |
Manage metadata of Hub items |
| Grants permission to manage metadata of Hub items API. |
Read metrics |
| Grants access to GET requests of the Metrics API v2. |
Write metrics |
| Grants access to the DELETE a custom metric request of the Metrics API v2. |
Read network zones |
| Grants access to GET requests of the Network zones API. |
Write network zones |
| Grants access to POST, PUT, and DELETE requests of the Network zones API. |
Read OneAgents |
| Grants access to GET requests of the OneAgents API. |
Write OneAgents |
| Grants access to POST and DELETE requests of the OneAgents API. |
Read problems |
| Grants access to GET requests of the Problems API v2. |
Write problems |
| Grants access to POST, PUT, and DELETE requests of the Problems API v2. |
Read releases |
| Grants access to the Releases API. |
Read security problems |
| Grants access to GET requests of the Security problems API. |
Write security problems |
| Grants access to POST requests of the Security problems API. |
Read settings |
| Grants access to GET requests of the Settings API. |
Write settings |
| Grants access to POST and DELETE requests of the Settings API. |
Read SLOs |
| Grants access to GET requests of the Service-level objectives API. |
Write SLOs |
| Grants access to POST, PUT, and DELETE requests of the Service-level objectives API. |
Read Unified Analysis page |
| Grants access to the Unified analysis schema in the Settings API. |