# 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 Endpoints API
  version: 1.0.0
extends: openapi/microsoft-azure-endpoints-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: 27
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List endpoints on a Digital Twins instance
      effect: read
      questions:
      - Which routing endpoints are configured on my Azure Digital Twins instance?
      - Can I see every egress endpoint attached to a Digital Twins instance at once?
      instructions:
      - text: List the endpoints on Digital Twins instance {instance} in resource group {rg}.
        slots:
          instance: path.resourceName
          rg: path.resourceGroupName
      - text: Show all Digital Twins endpoints for instance {instance} in subscription {sub}, resource group {rg}.
        slots:
          instance: path.resourceName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints/{endpointName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Digital Twins endpoint
      effect: read
      questions:
      - What is the configuration of a specific endpoint on my Digital Twins instance?
      - How can I check the provisioning state of one Digital Twins endpoint?
      instructions:
      - text: Get Digital Twins endpoint {endpoint} on instance {instance} in resource group {rg}.
        slots:
          endpoint: path.endpointName
          instance: path.resourceName
          rg: path.resourceGroupName
      - text: Show the details of twins endpoint {endpoint} in subscription {sub}, resource group {rg}, instance {instance}.
        slots:
          endpoint: path.endpointName
          sub: path.subscriptionId
          rg: path.resourceGroupName
          instance: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints/{endpointName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Digital Twins endpoint
      effect: write
      questions:
      - How do I add an Event Hub or Service Bus endpoint to a Digital Twins instance?
      - Can I change the settings of an existing Digital Twins routing endpoint?
      instructions:
      - text: Create Digital Twins endpoint {endpoint} on instance {instance} in resource group {rg} with properties {properties}.
        slots:
          endpoint: path.endpointName
          instance: path.resourceName
          rg: path.resourceGroupName
          properties: requestBody.properties
      - text: Update the twins endpoint {endpoint} on instance {instance} in subscription {sub}, group {rg}.
        slots:
          endpoint: path.endpointName
          instance: path.resourceName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints/{endpointName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Digital Twins endpoint
      effect: destructive
      questions:
      - How do I remove an endpoint from my Digital Twins instance?
      - What happens to event routing when I delete a Digital Twins endpoint?
      instructions:
      - text: Delete Digital Twins endpoint {endpoint} from instance {instance} in resource group {rg}.
        slots:
          endpoint: path.endpointName
          instance: path.resourceName
          rg: path.resourceGroupName
      - text: Remove the twins endpoint {endpoint} on instance {instance} in subscription {sub}, group {rg}.
        slots:
          endpoint: path.endpointName
          instance: path.resourceName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List CDN endpoints in a profile
      effect: read
      questions:
      - Which CDN endpoints exist under my Azure CDN profile?
      - Can I list every endpoint in a CDN profile to audit them?
      instructions:
      - text: List the CDN endpoints in profile {profile} in resource group {rg}.
        slots:
          profile: path.profileName
          rg: path.resourceGroupName
      - text: Show all endpoints under CDN profile {profile} in subscription {sub}, resource group {rg}.
        slots:
          profile: path.profileName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a CDN endpoint
      effect: read
      questions:
      - How do I look up the origin and hostname settings of one CDN endpoint?
      - Is my CDN endpoint currently running or stopped?
      instructions:
      - text: Get CDN endpoint {endpoint} in profile {profile}, resource group {rg}.
        slots:
          endpoint: path.endpointName
          profile: path.profileName
          rg: path.resourceGroupName
      - text: Show the configuration of CDN endpoint {endpoint} under profile {profile} in subscription {sub}, group {rg}.
        slots:
          endpoint: path.endpointName
          profile: path.profileName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a CDN endpoint
      effect: write
      questions:
      - How do I create a new CDN endpoint in front of my origin?
      - What location must I give when creating a CDN endpoint?
      instructions:
      - text: Create CDN endpoint {endpoint} in profile {profile}, resource group {rg}, in location {location}.
        slots:
          endpoint: path.endpointName
          profile: path.profileName
          rg: path.resourceGroupName
          location: requestBody.location
      - text: Set up a new CDN endpoint {endpoint} under profile {profile} in subscription {sub}, group {rg} with origin settings {properties}.
        slots:
          endpoint: path.endpointName
          profile: path.profileName
          sub: path.subscriptionId
          rg: path.resourceGroupName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a CDN endpoint
      effect: destructive
      questions:
      - How do I tear down a CDN endpoint I no longer need?
      - Can I delete a single CDN endpoint without removing the whole profile?
      instructions:
      - text: Delete CDN endpoint {endpoint} from profile {profile} in resource group {rg}.
        slots:
          endpoint: path.endpointName
          profile: path.profileName
          rg: path.resourceGroupName
      - text: Remove the CDN endpoint {endpoint} under profile {profile}, subscription {sub}, group {rg}.
        slots:
          endpoint: path.endpointName
          profile: path.profileName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a CDN endpoint
      effect: write
      questions:
      - What can I change on a CDN endpoint after it has been created?
      - How do I retag an existing CDN endpoint?
      instructions:
      - text: Update the tags on CDN endpoint {endpoint} in profile {profile}, resource group {rg} to {tags}.
        slots:
          endpoint: path.endpointName
          profile: path.profileName
          rg: path.resourceGroupName
          tags: requestBody.tags
      - text: Patch CDN endpoint {endpoint} under profile {profile} in subscription {sub}, group {rg}.
        slots:
          endpoint: path.endpointName
          profile: path.profileName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a stopped CDN endpoint
      effect: write
      questions:
      - How do I bring a stopped CDN endpoint back online?
      - Can I restart content delivery on an endpoint I paused earlier?
      instructions:
      - text: Start CDN endpoint {endpoint} in profile {profile}, resource group {rg}.
        slots:
          endpoint: path.endpointName
          profile: path.profileName
          rg: path.resourceGroupName
      - text: Turn the stopped CDN endpoint {endpoint} back on under profile {profile}, subscription {sub}, group {rg}.
        slots:
          endpoint: path.endpointName
          profile: path.profileName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a running CDN endpoint
      effect: write
      questions:
      - How do I temporarily stop a CDN endpoint from serving traffic?
      - Can I pause a running CDN endpoint without deleting it?
      instructions:
      - text: Stop CDN endpoint {endpoint} in profile {profile}, resource group {rg}.
        slots:
          endpoint: path.endpointName
          profile: path.profileName
          rg: path.resourceGroupName
      - text: Pause the running CDN endpoint {endpoint} under profile {profile}, subscription {sub}, group {rg}.
        slots:
          endpoint: path.endpointName
          profile: path.profileName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/purge'].post
  update:
    x-apievangelist-phrasing:
      intent: Purge cached content from a CDN endpoint
      effect: write
      questions:
      - How do I clear stale files from the CDN cache after a deploy?
      - Can I purge only specific paths instead of the whole CDN cache?
      instructions:
      - text: Purge {paths} from the cache of CDN endpoint {endpoint} in profile {profile}, resource group {rg}.
        slots:
          paths: requestBody.contentPaths
          endpoint: path.endpointName
          profile: path.profileName
          rg: path.resourceGroupName
      - text: Clear cached content at {paths} on endpoint {endpoint} under profile {profile}, subscription {sub}, group {rg}.
        slots:
          paths: requestBody.contentPaths
          endpoint: path.endpointName
          profile: path.profileName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/load'].post
  update:
    x-apievangelist-phrasing:
      intent: Pre-load content onto a CDN endpoint
      effect: write
      questions:
      - How do I warm the CDN cache with files before a launch?
      - Which CDN profiles support pre-loading content?
      instructions:
      - text: Pre-load {paths} onto CDN endpoint {endpoint} in profile {profile}, resource group {rg}.
        slots:
          paths: requestBody.contentPaths
          endpoint: path.endpointName
          profile: path.profileName
          rg: path.resourceGroupName
      - text: Warm the cache of endpoint {endpoint} under profile {profile}, subscription {sub}, group {rg} with {paths}.
        slots:
          paths: requestBody.contentPaths
          endpoint: path.endpointName
          profile: path.profileName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/validateCustomDomain'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a custom domain's DNS mapping to CDN
      effect: read
      questions:
      - How can I confirm my custom domain's CNAME points at the right CDN endpoint?
      - Why would a custom hostname fail DNS validation for my CDN endpoint?
      instructions:
      - text: Check that custom domain {hostname} maps to CDN endpoint {endpoint} in profile {profile}, resource group {rg}.
        slots:
          hostname: requestBody.hostName
          endpoint: path.endpointName
          profile: path.profileName
          rg: path.resourceGroupName
      - text: Validate DNS for hostname {hostname} against endpoint {endpoint} under profile {profile}, subscription {sub}, group {rg}.
        slots:
          hostname: requestBody.hostName
          endpoint: path.endpointName
          profile: path.profileName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/checkResourceUsage'].post
  update:
    x-apievangelist-phrasing:
      intent: Check geo filter and custom domain quota usage
      effect: read
      questions:
      - How many geo filters and custom domains have I used on a CDN endpoint versus the limit?
      - Am I close to the custom domain quota on my CDN endpoint?
      instructions:
      - text: Show geo filter and custom domain usage for CDN endpoint {endpoint} in profile {profile}, resource group {rg}.
        slots:
          endpoint: path.endpointName
          profile: path.profileName
          rg: path.resourceGroupName
      - text: Check quota consumption on endpoint {endpoint} under profile {profile}, subscription {sub}, group {rg}.
        slots:
          endpoint: path.endpointName
          profile: path.profileName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.HybridConnectivity/endpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List hybrid connectivity endpoints on a resource
      effect: read
      questions:
      - Which Hybrid Connectivity endpoints exist for my Arc-connected machine?
      - Can I see all remote-access endpoints configured on a hybrid resource?
      instructions:
      - text: List the hybrid connectivity endpoints on resource {resource}.
        slots:
          resource: path.resourceUri
      - text: Show every Hybrid Connectivity endpoint attached to {resource}.
        slots:
          resource: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.HybridConnectivity/endpoints/{endpointName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a hybrid connectivity endpoint
      effect: read
      questions:
      - How do I read the settings of the default Hybrid Connectivity endpoint on a machine?
      - What type is a given Hybrid Connectivity endpoint on my hybrid resource?
      instructions:
      - text: Get hybrid connectivity endpoint {endpoint} on resource {resource}.
        slots:
          endpoint: path.endpointName
          resource: path.resourceUri
      - text: Show the Hybrid Connectivity endpoint named {endpoint} for {resource}.
        slots:
          endpoint: path.endpointName
          resource: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.HybridConnectivity/endpoints/{endpointName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a hybrid connectivity endpoint
      effect: write
      questions:
      - How do I enable a Hybrid Connectivity endpoint so I can reach an Arc machine remotely?
      - Can I recreate a hybrid endpoint on a resource with new properties?
      instructions:
      - text: Create hybrid connectivity endpoint {endpoint} on resource {resource}.
        slots:
          endpoint: path.endpointName
          resource: path.resourceUri
      - text: Put Hybrid Connectivity endpoint {endpoint} on {resource} with properties {properties}.
        slots:
          endpoint: path.endpointName
          resource: path.resourceUri
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.HybridConnectivity/endpoints/{endpointName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a hybrid connectivity endpoint
      effect: destructive
      questions:
      - How do I revoke endpoint access to an Arc-connected resource?
      - Can I delete a Hybrid Connectivity endpoint to stop remote connections?
      instructions:
      - text: Delete hybrid connectivity endpoint {endpoint} from resource {resource}.
        slots:
          endpoint: path.endpointName
          resource: path.resourceUri
      - text: Revoke Hybrid Connectivity endpoint access {endpoint} on {resource}.
        slots:
          endpoint: path.endpointName
          resource: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.HybridConnectivity/endpoints/{endpointName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a hybrid connectivity endpoint
      effect: write
      questions:
      - How do I modify an existing Hybrid Connectivity endpoint in place?
      - Can I patch just the properties of a hybrid endpoint without recreating it?
      instructions:
      - text: Patch hybrid connectivity endpoint {endpoint} on resource {resource} with {properties}.
        slots:
          endpoint: path.endpointName
          resource: path.resourceUri
          properties: requestBody.properties
      - text: Update the Hybrid Connectivity endpoint {endpoint} for {resource}.
        slots:
          endpoint: path.endpointName
          resource: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.HybridConnectivity/endpoints/{endpointName}/listCredentials'].post
  update:
    x-apievangelist-phrasing:
      intent: Get access credentials for a hybrid endpoint
      effect: read
      questions:
      - How do I get a relay access token to connect to my Arc machine through its endpoint?
      - Can I choose how long the hybrid endpoint credentials stay valid?
      instructions:
      - text: Get access credentials for hybrid endpoint {endpoint} on resource {resource}.
        slots:
          endpoint: path.endpointName
          resource: path.resourceUri
      - text: Fetch connection credentials for endpoint {endpoint} on {resource} that expire in {seconds} seconds.
        slots:
          endpoint: path.endpointName
          resource: path.resourceUri
          seconds: query.expiresin
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.HybridConnectivity/endpoints/{endpointName}/listManagedProxyDetails'].post
  update:
    x-apievangelist-phrasing:
      intent: Get managed proxy details for a hybrid endpoint
      effect: read
      questions:
      - How do I find the managed proxy to use for SSH into an Arc server?
      - What proxy details does a hybrid endpoint return for a given service?
      instructions:
      - text: Get managed proxy details for service {service} on hybrid endpoint {endpoint} of resource {resource}.
        slots:
          service: requestBody.service
          endpoint: path.endpointName
          resource: path.resourceUri
      - text: Fetch the managed proxy for {service} on host {hostname} via endpoint {endpoint} on {resource}.
        slots:
          service: requestBody.service
          hostname: requestBody.hostname
          endpoint: path.endpointName
          resource: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/endpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List endpoints in a Storage Mover
      effect: read
      questions:
      - Which source and destination endpoints are defined in my Storage Mover?
      - Can I see all data transfer endpoints registered with a Storage Mover resource?
      instructions:
      - text: List the endpoints in Storage Mover {mover}.
        slots:
          mover: path.storageMoverName
      - text: Show every transfer source and target endpoint registered in storage mover {mover}.
        slots:
          mover: path.storageMoverName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/endpoints/{endpointName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Storage Mover endpoint
      effect: read
      questions:
      - What storage location does a particular Storage Mover endpoint point to?
      - How do I check the type of one endpoint in my Storage Mover?
      instructions:
      - text: Get endpoint {endpoint} in Storage Mover {mover}.
        slots:
          endpoint: path.endpointName
          mover: path.storageMoverName
      - text: Show the migration endpoint {endpoint} defined in storage mover {mover}.
        slots:
          endpoint: path.endpointName
          mover: path.storageMoverName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/endpoints/{endpointName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Storage Mover endpoint
      effect: write
      questions:
      - How do I register an NFS share or blob container as a Storage Mover endpoint?
      - Can I define the source or destination of a data migration in Storage Mover?
      instructions:
      - text: Create endpoint {endpoint} in Storage Mover {mover} with properties {properties}.
        slots:
          endpoint: path.endpointName
          mover: path.storageMoverName
          properties: requestBody.properties
      - text: Replace the definition of storage mover endpoint {endpoint} in {mover} using {properties}.
        slots:
          endpoint: path.endpointName
          mover: path.storageMoverName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/endpoints/{endpointName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Storage Mover endpoint
      effect: destructive
      questions:
      - How do I remove a transfer endpoint from my Storage Mover?
      - Can I delete a Storage Mover endpoint I no longer migrate data from?
      instructions:
      - text: Delete endpoint {endpoint} from Storage Mover {mover}.
        slots:
          endpoint: path.endpointName
          mover: path.storageMoverName
      - text: Remove the migration endpoint {endpoint} in storage mover {mover}.
        slots:
          endpoint: path.endpointName
          mover: path.storageMoverName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/endpoints/{endpointName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update properties of a Storage Mover endpoint
      effect: write
      questions:
      - How do I change the description of a Storage Mover endpoint without touching other settings?
      - Does patching a Storage Mover endpoint keep the properties I leave out?
      instructions:
      - text: Patch Storage Mover endpoint {endpoint} in {mover} with {properties}.
        slots:
          endpoint: path.endpointName
          mover: path.storageMoverName
          properties: requestBody.properties
      - text: Update only the given fields on migration endpoint {endpoint} of storage mover {mover}.
        slots:
          endpoint: path.endpointName
          mover: path.storageMoverName
      method: generated
      generated: '2026-09-26'