# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Datadog Assets API
  version: 1.0.0
extends: openapi/datadog-assets-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: 2
- target: $.paths['/api/v2/metrics/{metric_name}/assets'].get
  update:
    x-apievangelist-phrasing:
      intent: Find dashboards and monitors that use a metric
      effect: read
      questions:
      - Which dashboards, monitors, notebooks and SLOs use this metric?
      - Is it safe to drop a metric — what depends on it?
      instructions:
      - text: List the assets that use metric {metric_name}.
        slots:
          metric_name: path.metric_name
      - text: Show dashboards and monitors referencing {metric_name}.
        slots:
          metric_name: path.metric_name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/security/assets'].get
  update:
    x-apievangelist-phrasing:
      intent: List vulnerable assets
      effect: read
      questions:
      - Which of my assets have known vulnerabilities?
      - Can I see only vulnerable services running in production that are under attack?
      - How do I filter vulnerable hosts that are publicly accessible?
      instructions:
      - text: List my vulnerable assets.
      - text: List vulnerable assets in environment {environments}.
        slots:
          environments: query.filter[environments]
      - text: Show vulnerable assets of type {type} named {name}.
        slots:
          type: query.filter[type]
          name: query.filter[name]
      method: generated
      generated: '2026-10-01'