Datadog · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Datadog Queries API

3 actions 3 updates phrasing extends openapi/datadog-queries-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 3

$.info

$.paths['/api/v2/logs/config/restriction_queries/{restriction_query_id}'].patch

$.paths['/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles'].delete

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Datadog Queries API
  version: 1.0.0
extends: openapi/datadog-queries-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/logs/config/restriction_queries/{restriction_query_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a logs restriction query
      effect: write
      questions:
      - How do I change the query on a logs restriction query?
      - Can I edit which logs a restriction query lets roles see?
      instructions:
      - text: Update restriction query {restriction_query_id} with {data}.
        slots:
          restriction_query_id: path.restriction_query_id
          data: requestBody.data
      - text: Edit logs restriction query {restriction_query_id}.
        slots:
          restriction_query_id: path.restriction_query_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a role from a logs restriction query
      effect: destructive
      questions:
      - Can I unassign a role from a logs restriction query?
      - What's the way to revoke a role's restricted log access grant?
      instructions:
      - text: Remove role {data} from restriction query {restriction_query_id}.
        slots:
          data: requestBody.data
          restriction_query_id: path.restriction_query_id
      - text: Revoke restriction query {restriction_query_id} from role {data}.
        slots:
          restriction_query_id: path.restriction_query_id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'