# 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 API Key API
  version: 1.0.0
extends: openapi/microsoft-azure-api-key-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.Datadog/monitors/{monitorName}/listApiKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: List Datadog API keys for a monitor
      effect: read
      questions:
      - Which Datadog API keys are attached to my Datadog monitor resource?
      - Can I see all the API keys for a Datadog organization linked through a monitor?
      instructions:
      - text: List API keys for Datadog monitor {monitorName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          monitorName: path.monitorName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show every Datadog key on monitor {monitorName}.
        slots:
          monitorName: path.monitorName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Datadog/monitors/{monitorName}/getDefaultKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the default Datadog API key for a monitor
      effect: read
      questions:
      - Which Datadog API key is currently the default for my monitor?
      - How do I find the default key my Datadog monitor resource uses?
      instructions:
      - text: Get the default API key for Datadog monitor {monitorName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          monitorName: path.monitorName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show monitor {monitorName}'s default Datadog key.
        slots:
          monitorName: path.monitorName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Datadog/monitors/{monitorName}/setDefaultKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Set the default Datadog API key for a monitor
      effect: write
      questions:
      - Can I change which Datadog API key is the default for my monitor?
      - How do I make a different key the default on a Datadog monitor resource?
      instructions:
      - text: Set API key {key} as default for Datadog monitor {monitorName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          key: requestBody.key
          monitorName: path.monitorName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Make key {key} named {name} the default on monitor {monitorName}.
        slots:
          key: requestBody.key
          name: requestBody.name
          monitorName: path.monitorName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Elastic/getOrganizationApiKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch the Elastic organization API key
      effect: read
      questions:
      - Where can I retrieve the API key generated when my Elastic organization was created?
      - Can I look up the stored Elasticsearch organization API key for a user email?
      instructions:
      - text: Fetch the Elastic organization API key for {emailId}.
        slots:
          emailId: requestBody.emailId
      - text: Get the stored Elasticsearch organization API key for my user.
      method: generated
      generated: '2026-10-01'