# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Datadog Findings API
  version: 1.0.0
extends: openapi/datadog-findings-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: 1
- target: $.paths['/api/v2/posture_management/findings'].get
  update:
    x-apievangelist-phrasing:
      intent: List security posture findings
      effect: read
      questions:
      - Which misconfigurations are currently failing in my cloud accounts?
      - Can I list only identity risk findings?
      - Can I see findings that flipped from pass to fail recently?
      instructions:
      - text: List findings that fail or pass rule {rule_id}.
        slots:
          rule_id: query.filter[rule_id]
      - text: Show findings on resource type {resource_type}.
        slots:
          resource_type: query.filter[resource_type]
      - text: List findings tagged {tags}.
        slots:
          tags: query.filter[tags]
      - text: Show findings with status {status}, up to {limit}.
        slots:
          status: query.filter[status]
          limit: query.page[limit]
      method: generated
      generated: '2026-10-01'