Datadog · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Datadog Active API

4 actions 4 updates phrasing extends openapi/datadog-active-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Datadog's API. It is a proposal applied on top of the contract, not a document Datadog publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 4

$.info
$.paths['/api/v2/cost_by_tag/active_billing_dimensions'].get
$.paths['/api/v2/metrics/{metric_name}/active-configurations'].get
$.paths['/api/v2/monitor/{monitor_id}/downtime_matches'].get

OpenAPI Overlay

Raw ↑ 
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Datadog Active API
  version: 1.0.0
extends: openapi/datadog-active-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/api/v2/cost_by_tag/active_billing_dimensions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get active billing dimensions for cost attribution
      effect: read
      questions:
      - Which billing dimensions are active for cost attribution?
      - When is cost attribution data for last month available?
      instructions:
      - text: Show the active billing dimensions for cost attribution.
      - text: List billing dimensions we can attribute cost to.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/metrics/{metric_name}/active-configurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List actively queried tags for a metric
      effect: read
      questions:
      - Which tags of a metric are actually being queried on dashboards and monitors?
      - Can I find unused tags on a metric to cut custom metric costs?
      instructions:
      - text: List active tags and aggregations for metric {metric_name}.
        slots:
          metric_name: path.metric_name
      - text: Show actively queried tags on {metric_name} over the last {window} seconds.
        slots:
          metric_name: path.metric_name
          window: query.window[seconds]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/monitor/{monitor_id}/downtime_matches'].get
  update:
    x-apievangelist-phrasing:
      intent: List active downtimes for a monitor
      effect: read
      questions:
      - Is a specific monitor currently silenced by a downtime?
      - Which downtimes are matching a given monitor right now?
      instructions:
      - text: List active downtimes for monitor {monitor_id}.
        slots:
          monitor_id: path.monitor_id
      - text: Show which downtimes are muting monitor {monitor_id}.
        slots:
          monitor_id: path.monitor_id
      method: generated
      generated: '2026-10-01'