Dynatrace API

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.

Response codes

Unless otherwise specified, the following response codes are used:

API explorer

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

1. Select Settings in the navigation menu.
2. Go to Integration > Dynatrace API.
3. 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 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.