# 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 DeviceUpdateClient Deployment Management API
  version: 1.0.0
extends: openapi/microsoft-azure-deployment-management-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/deviceUpdate/{instanceId}/management/groups/{groupId}/deployments/{deploymentId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a device group deployment
      effect: destructive
      questions:
      - How do I delete a Device Update deployment for a device group?
      - Can I remove a deployment that targets a whole group of devices?
      instructions:
      - text: Delete deployment {deployment} from group {group} in Device Update instance {instance}.
        slots:
          deployment: path.deploymentId
          group: path.groupId
          instance: path.instanceId
      - text: Remove group-wide deployment {deployment} for group {group}, instance {instance}.
        slots:
          deployment: path.deploymentId
          group: path.groupId
          instance: path.instanceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deviceUpdate/{instanceId}/management/groups/{groupId}/deviceClassSubgroups/{deviceClassId}/deployments/{deploymentId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a device class subgroup deployment
      effect: destructive
      questions:
      - Can I delete a deployment for just one device class subgroup?
      - How do I remove an update deployment from a single device class in a group?
      instructions:
      - text: Delete deployment {deployment} for device class {deviceClass} in group {group}, instance {instance}.
        slots:
          deployment: path.deploymentId
          deviceClass: path.deviceClassId
          group: path.groupId
          instance: path.instanceId
      - text: Remove subgroup deployment {deployment} of device class {deviceClass}, group {group}, instance {instance}.
        slots:
          deployment: path.deploymentId
          deviceClass: path.deviceClassId
          group: path.groupId
          instance: path.instanceId
      method: generated
      generated: '2026-09-26'