generated: '2026-09-23'
method: searched
source: https://docs.datadoghq.com/api/latest.md
sources:
  - https://docs.datadoghq.com/api/latest.md
  - https://docs.datadoghq.com/api/latest/using-the-api.md
  - https://status.datadoghq.com/
  - openapi/datadog-api-openapi.yml
versioning:
  scheme: path-versioned
  description: >-
    Datadog exposes two active major versions in the URL path: /api/v1 (legacy)
    and /api/v2 (JSON:API-styled, current for new endpoints). Both are supported
    concurrently; SDKs expose both under version-suffixed namespaces
    (`datadogV1` / `datadogV2`).
  active_versions:
    - v1
    - v2
  documentation:
    - https://docs.datadoghq.com/api/v1/using-the-api.md
    - https://docs.datadoghq.com/api/v2/using-the-api.md
deprecation:
  policy: >-
    Individual endpoints are marked as deprecated in the OpenAPI contract. The
    documentation Change Notice banner highlights breaking changes. No dated
    Sunset/Deprecation HTTP headers (RFC 8594) are documented at the API layer.
  deprecated_operations_count: 19
  deprecated_operations:
    - method: GET
      path: /api/v2/apicatalog/api
      operationId: ListAPIs
    - method: DELETE
      path: /api/v2/apicatalog/api/{id}
      operationId: DeleteOpenAPI
    - method: GET
      path: /api/v2/apicatalog/api/{id}/openapi
      operationId: GetOpenAPI
    - method: PUT
      path: /api/v2/apicatalog/api/{id}/openapi
      operationId: UpdateOpenAPI
    - method: POST
      path: /api/v2/apicatalog/openapi
      operationId: CreateOpenAPI
    - method: GET
      path: /api/v2/services
      operationId: ListIncidentServices
    - method: POST
      path: /api/v2/services
      operationId: CreateIncidentService
    - method: DELETE
      path: /api/v2/services/{service_id}
      operationId: DeleteIncidentService
    - method: GET
      path: /api/v2/services/{service_id}
      operationId: GetIncidentService
    - method: PATCH
      path: /api/v2/services/{service_id}
      operationId: UpdateIncidentService
    - method: GET
      path: /api/v2/teams
      operationId: ListIncidentTeams
    - method: POST
      path: /api/v2/teams
      operationId: CreateIncidentTeam
    - method: DELETE
      path: /api/v2/teams/{team_id}
      operationId: DeleteIncidentTeam
    - method: GET
      path: /api/v2/teams/{team_id}
      operationId: GetIncidentTeam
    - method: PATCH
      path: /api/v2/teams/{team_id}
      operationId: UpdateIncidentTeam
    - method: GET
      path: /api/v2/usage/application_security
      operationId: GetUsageApplicationSecurityMonitoring
    - method: GET
      path: /api/v2/usage/cost_by_org
      operationId: GetCostByOrg
    - method: GET
      path: /api/v2/usage/lambda_traced_invocations
      operationId: GetUsageLambdaTracedInvocations
    - method: GET
      path: /api/v2/usage/observability_pipelines
      operationId: GetUsageObservabilityPipelines
status_page: https://status.datadoghq.com/
sla:
  documented: false
  note: >-
    No public SLA URL exposes numeric guarantees to public visitors; SLA terms
    are covered under Datadog's commercial agreements (see
    https://www.datadoghq.com/legal/).
regional_sites:
  - datadoghq.com
  - us3.datadoghq.com
  - us5.datadoghq.com
  - ap1.datadoghq.com
  - ap2.datadoghq.com
  - datadoghq.eu
  - ddog-gov.com