# 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 DELETE API
  version: 1.0.0
extends: openapi/microsoft-azure-delete-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}/privateEndpointConnections/{privateEndpointConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a private endpoint from a Databricks workspace
      effect: destructive
      questions:
      - How do I remove a private endpoint connection from an Azure Databricks workspace?
      - Can I disconnect a private endpoint from my Databricks workspace?
      instructions:
      - text: Remove private endpoint connection {connection} from Databricks workspace {workspace} in subscription {subscription}, resource group {resource_group}.
        slots:
          connection: path.privateEndpointConnectionName
          workspace: path.workspaceName
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
      - text: Delete Databricks workspace {workspace} private endpoint {connection}.
        slots:
          workspace: path.workspaceName
          connection: path.privateEndpointConnectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an IoT hub
      effect: destructive
      questions:
      - How do I delete an IoT hub I no longer need?
      - What happens to devices registered in an IoT hub when I delete it?
      instructions:
      - text: Delete IoT hub {hub} in subscription {subscription}, resource group {resource_group}.
        slots:
          hub: path.resourceName
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
      - text: Tear down the IoT hub named {hub}.
        slots:
          hub: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/eventHubEndpoints/{eventHubEndpointName}/ConsumerGroups/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a consumer group from an IoT hub endpoint
      effect: destructive
      questions:
      - Can I remove a consumer group from my IoT hub's Event Hub-compatible endpoint?
      - How do I clean up unused IoT hub consumer groups?
      instructions:
      - text: Delete consumer group {group} from endpoint {endpoint} on IoT hub {hub} in subscription {subscription}, resource group {resource_group}.
        slots:
          group: path.name
          endpoint: path.eventHubEndpointName
          hub: path.resourceName
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
      - text: Remove IoT hub {hub} consumer group {group}.
        slots:
          hub: path.resourceName
          group: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/iotHubs/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a private endpoint connection on an IoT hub
      effect: destructive
      questions:
      - How do I remove a private endpoint connection from an IoT hub?
      - Can I cut off private network access to my IoT hub?
      instructions:
      - text: Delete private endpoint connection {connection} on IoT hub {hub} in subscription {subscription}, resource group {resource_group}.
        slots:
          connection: path.privateEndpointConnectionName
          hub: path.resourceName
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
      - text: Remove IoT hub {hub} private endpoint {connection}.
        slots:
          hub: path.resourceName
          connection: path.privateEndpointConnectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollments/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an individual device enrollment
      effect: destructive
      questions:
      - How do I remove a single device enrollment from the provisioning service?
      - Can I delete an individual enrollment only if its ETag still matches?
      instructions:
      - text: Delete individual enrollment {registration}.
        slots:
          registration: path.id
      - text: Delete device enrollment {registration} if its ETag is {etag}.
        slots:
          registration: path.id
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollmentGroups/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a device enrollment group
      effect: destructive
      questions:
      - Can I delete a whole enrollment group from the Device Provisioning Service?
      - What stops new devices in a group from provisioning once the group is gone?
      instructions:
      - text: Delete enrollment group {group}.
        slots:
          group: path.id
      - text: Remove enrollment group {group} only if its ETag equals {etag}.
        slots:
          group: path.id
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/registrations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a device registration record
      effect: destructive
      questions:
      - How do I clear a device's registration state so it can provision again?
      - Can I delete a device registration record from DPS?
      instructions:
      - text: Delete the registration state for device {device}.
        slots:
          device: path.id
      - text: Remove device registration {device} with ETag {etag}.
        slots:
          device: path.id
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'