Dynatrace API

Use the Dynatrace API to automate your monitoring tasks and export different types of data into your third-party reporting and analysis tools. API communication ensures safety by using secured communication via the HTTPS protocol.

API access is limited to 50 requests per minute in the Dynatrace SaaS environment. There is no rate limit for Dynatrace Managed installations. Get in touch with your Dynatrace representative to increase this limit for SaaS environments.

The payload size is limited to 1 MB.

Read access to the Dynatrace API is free of charge on a fair use model. You are charged for defining and pushing new custom metrics through the Dynatrace API on a per-metric, per-month basis. For testing and prototyping, you have a free quota of 100 custom metrics per month for each Dynatrace SaaS environment or Dynatrace Managed cluster.

Authentication

The Dynatrace API uses a token mechanism for authentication. You need to generate the token and assign the required permissions to it. See Dynatrace API - Authentication to learn how.

Response codes

Unless otherwise specified, the following response codes are used:

Code	Description
200	OK. The request is successful.
400	Bad request. The request has failed. The body of the response provides additional details.
401	Unauthorized. The token authentication has failed. Check to see if your token has the required permissions.
404	Not found. The requested resource is not found in your environment. Check if your input is correct.

API explorer

You can also find the endpoints in the API explorer, where you can try them out:

Select Settings in the navigation menu.
Go to Integration > Dynatrace API.
Click the Dynatrace API Explorer link at the top of the page.

Alternatively you can access it via direct link:

Managed https://{your-domain}/e/{your-environment-id}/api-doc/index.jsp
SaaS https://{your-environment-id}.live.dynatrace.com/api-doc/index.jsp

Authentication in API explorer

For every API endpoint, click the lock Lock icon to show a dialog with information about the API tokens that secure the endpoint. Each endpoint demands a specific type of token.

You can also unlock all the endpoints, by clicking the global Authorize button. In the dialog, you can see which token permissions are necessary for all API endpoints. By entering your personal API token into the global Available authorizations dialog, you unlock all related API endpoints.

Try out an API call

Once you've entered your API token, you can directly execute API calls within the API explorer. A click on the Try it out button opens the parameter section of the selected API endpoint, where you can enter additional parameters and modify the request payload before executing it by clicking the Execute button.

The Dynatrace API provides the following endpoints: