How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Dynatrace Metrics API

Operations for querying, managing, and ingesting time-series metrics

Dynatrace Metrics API is one of 34 APIs that Dynatrace publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

This API exposes 106 JSON Schema definitions.

Tagged areas include Metrics. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a getting-started guide, an AsyncAPI specification, and 106 JSON Schemas.

This API exposes 5 operations across 4 paths, and defines 10 schemas. It is described by OpenAPI 3.2.0, at version 2.0.0.

Requests are made against a single base URL, https://{environmentId}.live.dynatrace.com/api/v2.

5 operations 4 paths 10 schemas 1 DELETE3 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.0.0
Base URL
https://mySampleEnv.live.dynatrace.com/api/v2
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Dynatrace Metrics API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (api-token). By default, every request must be authenticated.

  • api-token — Dynatrace API token. Use the format: Api-Token {your-token} Required scopes: metrics.read (for GET operations), metrics.ingest (for POST /metrics/ingest)

Paths & Operations 5

Across 4 paths, the API surfaces 5 operations — 1 DELETE, 3 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Metrics 5

Operations for querying, managing, and ingesting time-series metrics

GET
/metrics
Dynatrace List All Metrics
listMetrics 6 params → 200400401403
GET
/metrics/{metricKey}
Dynatrace Get Metric Descriptor
getMetricDescriptor 1 param → 200400401403404
DELETE
/metrics/{metricKey}
Dynatrace Delete Custom Metric
deleteCustomMetric 1 param → 204400401403404
GET
/metrics/query
Dynatrace Query Metric Data Points
queryMetricData 7 params → 200400401403
POST
/metrics/ingest
Dynatrace Ingest Custom Metrics
ingestCustomMetrics body → 202400401403

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are MetricDescriptor (12 properties), MetricSeries (4 properties), MetricDimensionDefinition (4 properties), MetricData (4 properties). Each schema is shown below with its type and property counts.

MetricData
object
The result of a metric query, containing time-series data for each requested metric and dimension combination.
4 properties
Error
object
Details of an API error.
3 properties
MetricDefaultAggregation
object
The default aggregation setting for the metric.
2 properties
ConstraintViolation
object
Details of a single constraint violation in a request.
4 properties
ErrorEnvelope
object
Error response envelope returned when a request fails.
1 property
MetricSeriesCollection
object
A collection of time-series data for a single metric key, containing one series per unique dimension combination.
2 properties
MetricDescriptor
object
Describes a single metric including its metadata, supported aggregations, entity dimensions, and default aggregation settings.
12 properties
MetricDimensionDefinition
object
Defines a single dimension of a metric.
4 properties
MetricSeries
object
A single time series representing metric values for a specific combination of dimension values over a time range.
4 properties 2 required
MetricDescriptorCollection
object
A paginated collection of metric descriptors returned by the list metrics endpoint.
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

dynatrace-metrics-api-openapi.yml Raw ↑

Other APIs Dynatrace publishes across the network.

Dynatrace Environment API
Dynatrace Synthetic API v2
Dynatrace Configuration API
Dynatrace OpenPipeline API
Dynatrace Automation API
Dynatrace Settings API 2.0
Dynatrace Extensions API 2.0
Dynatrace DQL/Grail Query API
Dynatrace Access Tokens API v2
Dynatrace Service-Level Objectives API
Dynatrace Releases API
Dynatrace Network Zones API
Where this information came from

This is an independent, third-party profile of Dynatrace Metrics API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.