Datadog

Datadog Metrics API

The metrics endpoint allows you to: - Post metrics data so it can be graphed on Datadog’s dashboards - Query metrics from any time period (timeseries and scalar) - Modify tag configurations for metrics - View tags and volumes for metrics **Note**: A graph can only contain a set number of points and as the timeframe over which a metric is viewed increases, aggregation between points occurs to stay below that set number. The Post, Patch, and Delete `manage_tags` API methods can only be performed by a user who has the `Manage Tags for Metrics` permission. See the [Metrics page](https://docs.datadoghq.com/metrics/) for more information.

GitHub OpenAPI
Business capability
Observability Management BC-4220.20

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

PATCH /api/v2/apm/config/metrics/{metric_id} Update a span-based metric · Datadog Update a Span-based Metric #
Ask an LLM
“Can I change the group-by tags on a span-based metric?”
“Is it possible to edit a metric generated from APM spans?”
Tell an agent
Update span-based metric {metric_id} with {data}.
Change the filter on span metric {metric_id}.
PATCH /api/v2/logs/config/metrics/{metric_id} Update a log-based metric · Datadog Update a Log-based Metric #
Ask an LLM
“Can I change the grouping on a metric generated from logs?”
“Is editing a log-based metric's filter possible?”
Tell an agent
Update log-based metric {metric_id} with {data}.
Change the group-by on log metric {metric_id}.
PATCH /api/v2/rum/config/metrics/{metric_id} Update a RUM-based metric · Datadog Update a Rum-based Metric #
Ask an LLM
“Can I edit a metric generated from RUM events?”
“Is it possible to add tags to a rum-based metric?”
Tell an agent
Update RUM-based metric {metric_id} with {data}.
Change the filter on RUM metric {metric_id}.
POST /api/v2/series Submit custom metric data points · Datadog Submit Metrics #
Ask an LLM
“How do I send my own time-series metrics to Datadog?”
“What's the maximum payload size when posting metrics?”
Tell an agent
Submit the series {series} to Datadog.
Post metrics {series} compressed with {encoding}.
POST /api/v2/query/timeseries Query metric timeseries data · Datadog Query Timeseries Data #
Ask an LLM
“Can I pull metric values over time for a chart outside Datadog?”
“Is it possible to run several metric queries in one timeseries request?”
Tell an agent
Query the timeseries for {data}.
Fetch CPU usage points over the last hour as a timeseries.
POST /api/v2/query/scalar Query a scalar metric value · Datadog Query Scalar Data #
Ask an LLM
“What was the average latency over the last day as a single number?”
“Can I compute a percentile across a time window in one value?”
Tell an agent
Compute a scalar value for {data}.
Get the summed request count for the past 24 hours as one value.

Documentation

📖
Documentation
https://docs.datadoghq.com/api/latest/
📖
Authentication
https://docs.datadoghq.com/api/latest/authentication/
📖
Documentation
https://docs.datadoghq.com/api/latest/metrics/
📖
Documentation
https://docs.datadoghq.com/api/latest/logs/
📖
Documentation
https://docs.datadoghq.com/api/latest/events/
📖
Documentation
https://docs.datadoghq.com/api/latest/monitors/
📖
Documentation
https://docs.datadoghq.com/api/latest/incidents/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/datadog/openapi/datadog-metrics-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/datadog/json-schema/datadog-metric-schema.json
📊
JSONSchema
https://artifacts.apis.io/datadog/json-schema/datadog-log-event-schema.json
📊
JSONSchema
https://artifacts.apis.io/datadog/json-schema/datadog-event-schema.json
📊
JSONSchema
https://artifacts.apis.io/datadog/json-schema/datadog-monitor-schema.json

Other Resources

🔗
GraphQL
https://artifacts.apis.io/datadog/graphql/datadog-graphql.md
🔗
Reference
https://docs.datadoghq.com/metrics/
🔗
Reference
https://docs.datadoghq.com/logs/
🔗
Reference
https://docs.datadoghq.com/service_management/events/
🔗
Reference
https://docs.datadoghq.com/monitors/
🔗
Reference
https://docs.datadoghq.com/service_management/incident_management/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/datadog:datadog-metrics-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

datadog-metrics-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Datadog Metrics API
  version: '1.0'
  description: 'Operations tagged Metrics across 2 of this provider''s published API definitions: datadog-api-openapi.yml, datadog-metrics-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{subdomain}.{site}
  variables:
    site:
      default: datadoghq.com
      description: The regional site for Datadog customers.
      enum:
      - datadoghq.com
      - us3.datadoghq.com
      - us5.datadoghq.com
      - ap1.datadoghq.com
      - datadoghq.eu
      - ddog-gov.com
    subdomain:
      default: api
      description: The subdomain where the API is deployed.
- url: '{protocol}://{name}'
  variables:
    name:
      default: api.datadoghq.com
      description: Full site DNS name.
    protocol:
      default: https
      description: The protocol for accessing the API.
- url: https://api.datadoghq.com
  description: Datadog API Production Server
tags:


# --- truncated at 32 KB (58 KB total) ---
# Full source: https://artifacts.apis.io/datadog/openapi/datadog-metrics-api-openapi.yml