Datadog

Datadog Events API

The Event Management API allows you to programmatically post events to the Events Explorer and fetch events from the Events Explorer. See the [Event Management page](https://docs.datadoghq.com/service_management/events/) for more information. **Update to Datadog monitor events `aggregation_key` starting March 1, 2025:** The Datadog monitor events `aggregation_key` is unique to each Monitor ID. Starting March 1st, this key will also include Monitor Group, making it unique per *Monitor ID and Monitor Group*. If you're using monitor events `aggregation_key` in dashboard queries or the Event API, you must migrate to use `@monitor.id`. Reach out to [support](https://www.datadoghq.com/support/) if you have any question.

GitHub OpenAPI

Operations 14

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

POST /api/v2/ci/pipeline Send a CI pipeline event · Datadog Send Pipeline Event #
Ask an LLM
“How do I report a pipeline run from an unsupported CI provider to CI Visibility?”
“Can I send pipeline execution data over HTTP?”
Tell an agent
Send this CI pipeline event to CI Visibility: {data}.
Report a finished pipeline run with {data}.
GET /api/v2/ci/pipelines/events List CI pipeline events · Datadog Get a List of Pipelines Events #
Ask an LLM
“Which CI pipelines ran in the last hour?”
“Can I page through pipeline events with a cursor?”
Tell an agent
List my latest CI pipeline events.
List pipeline events matching {query} between {from} and {to}.
POST /api/v2/ci/pipelines/events/search Search CI pipeline events with complex filters · Datadog Search Pipelines Events #
Ask an LLM
“How do I run a complex search across CI pipeline events?”
“Can I search pipeline events with a timezone offset and custom sort?”
Tell an agent
Search CI pipeline events with filter {filter}.
Run a pipeline event search using {filter} sorted by {sort}.
GET /api/v2/ci/tests/events List CI test events · Datadog Get a List of Tests Events #
Ask an LLM
“Which tests ran in my CI recently?”
“Can I list test events from a specific time window?”
Tell an agent
List my latest CI test events.
List test events matching {query} between {from} and {to}.
POST /api/v2/ci/tests/events/search Search CI test events with complex filters · Datadog Search Tests Events #
Ask an LLM
“How can I search CI test events, for example to find flaky failures?”
“Is there a POST search for test events that supports paging options?”
Tell an agent
Search CI test events with filter {filter}.
Run a test event search using {filter} and paging {page}.
POST /api/v2/dora/failures List DORA failure events · Datadog Get a List of Failure Events #
Ask an LLM
“Which DORA failure events have been recorded for my services?”
“Can I query failure events used for change failure rate?”
Tell an agent
List DORA failure events matching {data}.
Get DORA failures for the query {data}.
GET /api/v2/dora/failures/{failure_id} Get a DORA failure event · Datadog Get a Failure Event #
Ask an LLM
“How can I look up one DORA failure event by ID?”
“What details does a single failure event include?”
Tell an agent
Get DORA failure event {failure_id}.
Show the failure event {failure_id}.
POST /api/v2/dora/incident Send an incident event for DORA metrics · Datadog Send an Incident Event for Dora Metrics #
Ask an LLM
“How do I feed incident data into DORA change failure rate and time to restore?”
“Can I report a production failure for DORA metrics?”
Tell an agent
Send a DORA incident event with {data}.
Record a failure for DORA metrics using {data}.
GET /api/v2/events List recent events · Datadog Get a List of Events #
Ask an LLM
“What events happened in my Datadog org in the last 24 hours?”
“Can I filter the event stream by a search query and millisecond timestamps?”
Tell an agent
List my latest events.
List events matching {query} from {from} to {to}.
POST /api/v2/events Post a change event · Datadog Post an Event #
Ask an LLM
“How do I post a deployment or config change event for Change Tracking?”
“Which event categories are generally available when posting events?”
Tell an agent
Post this change event: {data}.
Record a change event for Change Tracking with {data}.
POST /api/v2/events/search Search events with complex filters · Datadog Search Events #
Ask an LLM
“How can I build a complex event search with custom sorting?”
“Can I search events using a timezone instead of a time offset?”
Tell an agent
Search events with filter {filter}.
Run an event search using {filter} sorted by {sort}.
GET /api/v2/rum/events List RUM events · Datadog Get a List of Rum Events #
Ask an LLM
“What are the latest real user sessions and views captured by RUM?”
“Can I list RUM events with a RUM search query?”
Tell an agent
List my latest RUM events.
List RUM events matching {query} between {from} and {to}.
POST /api/v2/rum/events/search Search RUM events with complex filters · Datadog Search Rum Events #
Ask an LLM
“How do I run a complex search over RUM events?”
“Is there a POST endpoint for filtering RUM events with paging?”
Tell an agent
Search RUM events with filter {filter}.
Run a RUM event search using {filter} and paging {page}.
GET /api/v2/events/{event_id} Get an event by ID · Datadog Get an Event #
Ask an LLM
“How can I see the full details of one event, including tags and hosts?”
“Can I fetch an event using the ID returned when I posted it?”
Tell an agent
Get event {event_id}.
Show full details for event {event_id}.

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://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/openapi/datadog-events-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-metric-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-log-event-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-event-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-monitor-schema.json

Other Resources

🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/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-events-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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-events-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Datadog Events API
  version: '1.0'
  description: 'Operations tagged Events across 2 of this provider''s published API definitions: datadog-api-openapi.yml, datadog-events-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 (130 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/openapi/datadog-events-api-openapi.yml