# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Datadog Audit API
  version: 1.0.0
extends: openapi/datadog-audit-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/audit/events'].get
  update:
    x-apievangelist-phrasing:
      intent: List recent audit log events
      effect: read
      questions:
      - Who changed what in our Datadog org recently?
      - Can I see audit events from a particular time window?
      instructions:
      - text: List audit events matching {query}.
        slots:
          query: query.filter[query]
      - text: Show audit log events from {from} to {to}.
        slots:
          from: query.filter[from]
          to: query.filter[to]
      - text: Show the latest audit log events.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/audit/events/search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search audit logs with a complex query
      effect: read
      questions:
      - Can I run an advanced filtered search over audit logs with a timezone?
      - Is there a POST search for audit events that supports complex filters?
      instructions:
      - text: Search audit logs using filter {filter}.
        slots:
          filter: requestBody.filter
      - text: Search audit events with filter {filter} sorted by {sort}.
        slots:
          filter: requestBody.filter
          sort: requestBody.sort
      method: generated
      generated: '2026-10-01'