Microsoft Azure · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Microsoft Azure DELETE API

8 actions 8 updates phrasing extends openapi/microsoft-azure-delete-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Microsoft Azure's API. It is a proposal applied on top of the contract, not a document Microsoft Azure publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 8

$.info
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}/privateEndpointConnections/{privateEndpointConnectionName}'].delete
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}'].delete
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/eventHubEndpoints/{eventHubEndpointName}/ConsumerGroups/{name}'].delete
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/iotHubs/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}'].delete
$.paths['/enrollments/{id}'].delete
$.paths['/enrollmentGroups/{id}'].delete
$.paths['/registrations/{id}'].delete

OpenAPI Overlay

Raw ↑ 
# 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'

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay 
curl "https://apis.io/api/v1/overlays/microsoft-azure-delete-api-phrasing-overlay"
All openapi overlays 
curl "https://apis.io/api/v1/overlays?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.