Tokens API v1 - GET all tokens

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	ManagedDynatrace for Government	`https://{your-domain}/e/{your-environment-id}/api/v1/tokens`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v1/tokens`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/v1/tokens`

Authentication

To execute this request, you need an access token with TenantTokenManagement scope.

To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter	Type	Description	In	Required
limit	integer	Limits the maximum number of returned tokens. If not set the value of `1000` is used. 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: `permissions=scope1&permissions=scope2`. The token must have all the specified scopes. The element can hold these values `ActiveGateCertManagement` `AdvancedSyntheticIntegration` `CaptureRequestData` `DTAQLAccess` `DataExport` `DataImport` `DataPrivacy` `Davis` `DiagnosticExport` `DssFileManagement` `ExternalSyntheticIntegration` `InstallerDownload` `LogExport` `MemoryDump` `Mobile` `PluginUpload` `ReadConfig` `ReadSyntheticData` `RestRequestForwarding` `RumBrowserExtension` `RumJavaScriptTagManagement` `SupportAlert` `TenantTokenManagement` `UserSessionAnonymization` `ViewDashboard` `ViewReport` `WriteConfig` `WriteSyntheticData` `activeGateTokenManagement.create` `activeGateTokenManagement.read` `activeGateTokenManagement.write` `activeGates.read` `activeGates.write` `analyzers.read` `analyzers.write` `apiTokens.read` `apiTokens.write` `attacks.read` `attacks.write` `auditLogs.read` `credentialVault.read` `credentialVault.write` `entities.read` `entities.write` `events.ingest` `events.read` `extensionConfigurations.read` `extensionConfigurations.write` `extensionEnvironment.read` `extensionEnvironment.write` `extensions.read` `extensions.write` `geographicRegions.read` `hub.install` `hub.read` `hub.write` `javaScriptMappingFiles.read` `javaScriptMappingFiles.write` `logs.ingest` `logs.read` `metrics.ingest` `metrics.read` `metrics.write` `networkZones.read` `networkZones.write` `oneAgents.read` `oneAgents.write` `openTelemetryTrace.ingest` `problems.read` `problems.write` `releases.read` `securityProblems.read` `securityProblems.write` `settings.read` `settings.write` `slo.read` `slo.write` `syntheticExecutions.read` `syntheticExecutions.write` `syntheticLocations.read` `syntheticLocations.write` `tenantTokenRotation.write` `traces.lookup`	query	optional
from	integer	Last used after this timestamp (UTC milliseconds).	query	optional
to	integer	Last used before this timestamp (UTC milliseconds).	query	optional

Response

Response codes

Code	Type	Description
200	StubList	Success

Response body objects

The `StubList` object

An ordered list of short representations of Dynatrace entities.

Element	Type	Description
values	EntityShortRepresentation[]	An ordered list of short representations of Dynatrace entities.

The `EntityShortRepresentation` object

The short representation of a Dynatrace entity.

Element	Type	Description
id	string	The ID of the Dynatrace entity.
name	string	The name of the Dynatrace entity.
description	string	A short description of the Dynatrace entity.

Response body JSON model

json
{
  "values": [
    {
      "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
      "name": "Dynatrace entity 1",
      "description": "Dynatrace entity 1 for the REST API example"
    },
    {
      "id": "ee70f7d3-9a4e-4f5f-94d2-c9d6156f1618",
      "name": "Dynatrace entity 2"
    },
    {
      "id": "8cdabe77-9e1a-4be8-b3df-269dd6fa9d7f"
    }
  ]
}

Example

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

bash
curl -X GET \
  https://mySampleEnv.live.dynatrace.com/api/v1/tokens \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

plaintext
https://mySampleEnv.live.dynatrace.com/api/v1/tokens

Response body

json
{
  "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"
    }
  ]
}

Response code

200

Tokens API v1 - GET all tokens

Authentication

Parameters

Response

Response codes

Response body objects

The StubList object

The EntityShortRepresentation object

Response body JSON model

Example

Curl

Request URL

Response body

Response code

The `StubList` object

The `EntityShortRepresentation` object