Datadog APM · OpenAPI Overlay 1.0.0

API Evangelist enrichment overlay — Datadog APM Spans API

3 actions 3 updates update extends openapi/datadog-apm-spans-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Datadog APM's API. It is a proposal applied on top of the contract, not a document Datadog APM publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-api-evangelistx-idempotencyx-rate-limit-signalx-site-scoping

Targets 2

$.info

$.servers

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enrichment overlay — Datadog APM Spans API
  version: 1.0.0
x-generated: '2026-09-05'
x-method: generated
x-source: openapi/datadog-apm-spans-api-openapi.yml
x-note: Captures API Evangelist enrichment as an OpenAPI Overlay. The provider-published contract in openapi/
  is never mutated.
extends: openapi/datadog-apm-spans-api-openapi.yml
actions:
- target: $.info
  description: Record the API Evangelist enrichment context alongside the provider-published contract.
  update:
    x-api-evangelist:
      provider: Datadog APM
      providerId: datadog-apm
      artifacts:
        authentication: authentication/datadog-apm-authentication.yml
        scopes: scopes/datadog-apm-scopes.yml
        conventions: conventions/datadog-apm-conventions.yml
        errors: errors/datadog-apm-problem-types.yml
        rate_limits: rate-limits/datadog-apm-rate-limits.yml
        lifecycle: lifecycle/datadog-apm-lifecycle.yml
        data_model: data-model/datadog-apm-data-model.yml
        mcp: mcp/datadog-apm-mcp.yml
        tool_crosswalk: mcp/datadog-apm-tool-crosswalk.yml
- target: $.info
  description: 'Runtime semantics an agent needs that the contract does not state: no idempotency mechanism,
    and a 429 on every operation.'
  update:
    x-idempotency:
      coverage: none
      header: null
      note: Datadog documents no Idempotency-Key header for the APM surface. Retrying a create duplicates
        the resource.
    x-rate-limit-signal:
      status: 429
      headers:
      - X-RateLimit-Limit
      - X-RateLimit-Period
      - X-RateLimit-Remaining
      - X-RateLimit-Reset
      - X-RateLimit-Name
      source: https://docs.datadoghq.com/api/latest/rate-limits/
    x-site-scoping: The servers[] block is templated because Datadog is multi-site; an API key is valid
      on exactly one site host.
- target: $.servers
  description: Name the default site host so a reader does not have to resolve the template to make a
    call.
  update:
  - url: https://api.datadoghq.com
    description: Default US1 site — the concrete resolution of https://{subdomain}.{site} with subdomain=api
      and site=datadoghq.com. Documented at https://docs.datadoghq.com/getting_started/site/.

Work with this as data

Every overlay 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 openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
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 overlay

curl "https://apis.io/api/v1/overlays/datadog-apm-spans-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?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.