This API is deprecated. Use the Access tokens API instead.
Lists all Dynatrace API authentication tokens of your environment. The list contains only the names and IDs of tokens. You can retrieve details either by the ID of the token or by the token itself.
The request produces an application/json
payload.
GET | SaaS | https://{your-environment-id}.live.dynatrace.com/api/v1/tokens |
Environment ActiveGate | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v1/tokens |
To execute this request, you need an access token with TenantTokenManagement
scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameter | Type | Description | In | Required |
---|---|---|---|---|
limit | integer | Limits the maximum number of returned tokens. If not set the value of Maximum value is 1000000. | query | optional |
user | string | Filters the resulting set of tokens by user, who owns the token. | query | optional |
permissions | string[] | Filters the resulting set of tokens by scopes assigned to the token. You can specify several permissions in the following format:
| query | optional |
from | integer | Last used after this timestamp (UTC milliseconds). | query | optional |
to | integer | Last used before this timestamp (UTC milliseconds). | query | optional |
Code | Type | Description |
---|---|---|
200 | Stub | Success |
4XX | Error | Client side error. |
5XX | Error | Server side error. |
StubList
objectAn ordered list of short representations of Dynatrace entities.
Element | Type | Description |
---|---|---|
values | Entity | An ordered list of short representations of Dynatrace entities. |
EntityShortRepresentation
objectThe short representation of a Dynatrace entity.
Element | Type | Description |
---|---|---|
description | string | A short description of the Dynatrace entity. |
id | string | The ID of the Dynatrace entity. |
name | string | The name of the Dynatrace entity. |
{"values": [{"description": "Dynatrace entity 1 for the REST API example","id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a","name": "Dynatrace entity 1"},{"id": "ee70f7d3-9a4e-4f5f-94d2-c9d6156f1618","name": "Dynatrace entity 2"},{"id": "8cdabe77-9e1a-4be8-b3df-269dd6fa9d7f"}]}
In this example, the request lists all API tokens of the mySampleEnv
environment.
The API token is passed in the Authorization header.
The result is truncated to three entries.
curl -X GET \https://mySampleEnv.live.dynatrace.com/api/v1/tokens \-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
https://mySampleEnv.live.dynatrace.com/api/v1/tokens
{"values": [{"id": "d5836312-5790-4e80-afcf-09971954c3ea","name": "admin"},{"id": "ab42e02c-fbbe-413c-b225-9a87d5efbd60","name": "dev token"},{"id": "434d9b21-1e38-4be3-8b90-5a76d531ca53","name": "devops"}]}
200