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.
# 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'
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.