Tokens API - GET all tokens

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
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/tokens
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/tokens

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
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 array

Filters the resulting set of tokens by permissions, assigned to the token.

You can specify several permissions in the following format: permissions=permission1&permissions=permission2. The token must have all the specified permissions.

query optional
from integer

Last used after this timestamp (UTC milliseconds).

query optional
to integer

Last used before this timestamp (UTC milliseconds).

query optional

Possible values

Possible values for the items element:

  • ActiveGateCertManagement
  • AdvancedSyntheticIntegration
  • AppMonIntegration
  • CaptureRequestData
  • DTAQLAccess
  • DataExport
  • DataImport
  • DataPrivacy
  • Davis
  • DcrumIntegration
  • DiagnosticExport
  • DssFileManagement
  • ExternalSyntheticIntegration
  • InstallerDownload
  • LogExport
  • LogImport
  • MemoryDump
  • Mobile
  • PluginUpload
  • ReadAuditLogs
  • ReadConfig
  • ReadSyntheticData
  • RestRequestForwarding
  • RumBrowserExtension
  • RumJavaScriptTagManagement
  • SupportAlert
  • TenantTokenManagement
  • UserSessionAnonymization
  • ViewDashboard
  • ViewReport
  • WriteConfig
  • WriteSyntheticData
  • credentialVault.read
  • credentialVault.write
  • entities.read
  • entities.write
  • networkZones.read
  • networkZones.write

Response format

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.

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

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

Request URL

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

Response body

{
  "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