# 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 DevTestLabsClient Notification Channels API
  version: 1.0.0
extends: openapi/microsoft-azure-notification-channels-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: 6
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/notificationchannels'].get
  update:
    x-apievangelist-phrasing:
      intent: List notification channels in a DevTest lab
      effect: read
      questions:
      - Which notification channels are set up in my DevTest Labs lab?
      - Can I sort or filter a lab's notification channels?
      instructions:
      - text: List notification channels in lab {labName} under {resourceGroupName}, subscription {subscriptionId}.
        slots:
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the first {top} notification channels in lab {labName} matching {filter}.
        slots:
          top: query.$top
          labName: path.labName
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/notificationchannels/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a lab notification channel
      effect: read
      questions:
      - Where does a particular lab notification channel send its alerts?
      - How do I view one notification channel's webhook and events?
      instructions:
      - text: Get notification channel {name} in lab {labName}.
        slots:
          name: path.name
          labName: path.labName
      - text: Show channel {name} of lab {labName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          name: path.name
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/notificationchannels/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a lab notification channel
      effect: write
      questions:
      - How do I set up a webhook so my lab tells me about auto-shutdown?
      - Can I fully replace a lab notification channel's definition?
      instructions:
      - text: Create notification channel {name} in lab {labName} with properties {properties}.
        slots:
          name: path.name
          labName: path.labName
          properties: requestBody.properties
      - text: Replace channel {name} in lab {labName} under {resourceGroupName}, subscription {subscriptionId}.
        slots:
          name: path.name
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/notificationchannels/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a lab notification channel
      effect: destructive
      questions:
      - How do I stop a lab from sending notifications to a channel?
      - Can I delete a DevTest Labs notification channel?
      instructions:
      - text: Delete notification channel {name} from lab {labName}.
        slots:
          name: path.name
          labName: path.labName
      - text: Remove channel {name} of lab {labName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          name: path.name
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/notificationchannels/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change tags on a lab notification channel
      effect: write
      questions:
      - Can I edit anything besides tags when patching a notification channel?
      - How do I retag an existing lab notification channel?
      instructions:
      - text: Set tags {tags} on notification channel {name} in lab {labName}.
        slots:
          tags: requestBody.tags
          name: path.name
          labName: path.labName
      - text: Retag channel {name} of lab {labName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          name: path.name
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/notificationchannels/{name}/notify'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a notification through a lab channel
      effect: write
      questions:
      - How do I test a lab notification channel by sending it an event?
      - Can I push a custom JSON payload through a notification channel?
      instructions:
      - text: Send event {eventName} through channel {name} in lab {labName}.
        slots:
          eventName: requestBody.eventName
          name: path.name
          labName: path.labName
      - text: Notify channel {name} of lab {labName} in {resourceGroupName}, subscription {subscriptionId}, with payload {jsonPayload}.
        slots:
          name: path.name
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          jsonPayload: requestBody.jsonPayload
      method: generated
      generated: '2026-10-01'