# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Azure Resource Graph Query API
  version: 1.0.0
extends: openapi/microsoft-azure-graph-query-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries'].get
  update:
    x-apievangelist-phrasing:
      intent: List saved Resource Graph queries
      effect: read
      questions:
      - Which saved Azure Resource Graph queries exist in a resource group?
      - How can I see all the shared graph queries my team has stored?
      instructions:
      - text: List saved graph queries in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show every shared Resource Graph query in {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries/{resourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a saved Resource Graph query
      effect: read
      questions:
      - How do I read the KQL text of a saved graph query?
      - Can I fetch one shared Resource Graph query by its name?
      instructions:
      - text: Get graph query {resourceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the query text of saved query {resourceName} in group {resourceGroupName}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Save a new Resource Graph query
      effect: write
      questions:
      - How do I save a Resource Graph query so others on my team can reuse it?
      - Can I store a KQL query as an Azure resource with tags?
      instructions:
      - text: Save graph query {resourceName} in {resourceGroupName}, subscription {subscriptionId}, with {properties}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      - text: Create shared query {resourceName} in group {resourceGroupName} tagged {tags}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          tags: requestBody.tags
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries/{resourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a saved Resource Graph query
      effect: destructive
      questions:
      - How do I remove a shared graph query nobody uses anymore?
      - Can I delete a saved Resource Graph query by name?
      instructions:
      - text: Delete graph query {resourceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove saved query {resourceName} from group {resourceGroupName}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'