API Evangelist conversational phrasing for Microsoft Azure Apps API

# 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 Apps API
  version: 1.0.0
extends: openapi/microsoft-azure-apps-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: 178
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an IoT Central application's metadata
      effect: read
      questions:
      - What metadata does Azure keep for one of my IoT Central applications?
      - Where can I see the SKU and subdomain of an existing IoT Central app?
      instructions:
      - text: Show the IoT Central app {resourceName} in resource group {resourceGroupName}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
      - text: Get the details of IoT Central application {resourceName} in subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace an IoT Central application
      effect: write
      questions:
      - How do I provision a new IoT Central application in a resource group?
      - Which SKU and region must I supply when creating an IoT Central app?
      instructions:
      - text: Create IoT Central app {resourceName} in {location} on SKU {sku}.
        slots:
          resourceName: path.resourceName
          location: requestBody.location
          sku: requestBody.sku
      - text: Replace the full metadata of IoT Central app {resourceName} with properties {properties}.
        slots:
          resourceName: path.resourceName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an IoT Central application
      effect: destructive
      questions:
      - Can I permanently remove an IoT Central application I no longer use?
      - What happens when I delete an IoT Central app from its resource group?
      instructions:
      - text: Delete the IoT Central app {resourceName} from resource group {resourceGroupName}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
      - text: Tear down IoT Central application {resourceName} in subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an IoT Central application's tags or SKU
      effect: write
      questions:
      - Can I change just the tags or SKU on an existing IoT Central app without recreating it?
      - How do I patch the managed identity setting of an IoT Central application?
      instructions:
      - text: Change the SKU of IoT Central app {resourceName} in {resourceGroupName} to {sku}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          sku: requestBody.sku
      - text: Update the tags on IoT Central application {resourceName} in subscription {subscriptionId} to {tags}.
        slots:
          resourceName: path.resourceName
          subscriptionId: path.subscriptionId
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/iotApps'].get
  update:
    x-apievangelist-phrasing:
      intent: List IoT Central applications in a subscription
      effect: read
      questions:
      - Which IoT Central applications exist across my whole Azure subscription?
      - Is there a way to inventory every IoT Central app I own, regardless of resource group?
      instructions:
      - text: List all IoT Central applications in my subscription.
      - text: Show every IoT Central app across all resource groups of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps'].get
  update:
    x-apievangelist-phrasing:
      intent: List IoT Central applications in a resource group
      effect: read
      questions:
      - What IoT Central apps live in one particular resource group?
      - Can I narrow my IoT Central app inventory to a single resource group?
      instructions:
      - text: List the IoT Central apps in resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      - text: Show IoT Central applications that belong to {resourceGroupName} in subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check whether an IoT Central app name is free
      effect: read
      questions:
      - Is a given IoT Central application name already taken?
      - Can I verify an IoT Central app name is available before I create the app?
      instructions:
      - text: Check if the IoT Central application name {name} is available.
        slots:
          name: requestBody.name
      - text: See whether I can use {name} as a new IoT Central app name in subscription {subscriptionId}.
        slots:
          name: requestBody.name
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/checkSubdomainAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check whether an IoT Central subdomain is free
      effect: read
      questions:
      - Is the subdomain I want for my IoT Central app still available?
      - How can I test an IoT Central subdomain for availability ahead of provisioning?
      instructions:
      - text: Check if the IoT Central subdomain {name} is available.
        slots:
          name: requestBody.name
      - text: Verify nobody has already claimed the IoT Central subdomain {name}, checking from subscription {subscriptionId}.
        slots:
          name: requestBody.name
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/appTemplates'].post
  update:
    x-apievangelist-phrasing:
      intent: List IoT Central application templates
      effect: read
      questions:
      - What application templates can I start a new IoT Central app from?
      - Which IoT Central industry templates are available to me?
      instructions:
      - text: List all available IoT Central application templates.
      - text: Show me the IoT Central app templates available to subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/phraselists'].get
  update:
    x-apievangelist-phrasing:
      intent: List phrase list features in a LUIS app version
      effect: read
      questions:
      - Which phrase lists are defined in a version of my LUIS app?
      - Can I page through phrase list features with skip and take?
      instructions:
      - text: List the phrase lists in version {versionId} of LUIS app {appId}.
        slots:
          versionId: path.versionId
          appId: path.appId
      - text: Show the first {take} phrase list features of app {appId} version {versionId}.
        slots:
          take: query.take
          appId: path.appId
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/phraselists'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a phrase list feature in a LUIS app version
      effect: write
      questions:
      - How do I add a phrase list of related words to my LUIS app?
      - Can a new phrase list be marked interchangeable or enabled for all models?
      instructions:
      - text: Add a phrase list named {name} with phrases {phrases} to app {appId} version {versionId}.
        slots:
          name: requestBody.name
          phrases: requestBody.phrases
          appId: path.appId
          versionId: path.versionId
      - text: Create an interchangeable phrase list {name} in LUIS app {appId} version {versionId}.
        slots:
          name: requestBody.name
          appId: path.appId
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/features'].get
  update:
    x-apievangelist-phrasing:
      intent: List all features in a LUIS app version
      effect: read
      questions:
      - Which phrase list and pattern features does one version of my LUIS app use?
      - Can I see every extraction feature of a LUIS version together, not just phrase lists?
      instructions:
      - text: List all phrase list and pattern features in version {versionId} of LUIS app {appId}.
        slots:
          versionId: path.versionId
          appId: path.appId
      - text: Show {take} features of LUIS app {appId} version {versionId}, skipping {skip}.
        slots:
          take: query.take
          skip: query.skip
          appId: path.appId
          versionId: path.versionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/apps/{appId}/versions/{versionId}/phraselists/{phraselistId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one phrase list feature
      effect: read
      questions:
      - What words are inside a specific phrase list in LUIS?
      - Can I check whether a particular phrase list is active?
      instructions:
      - text: Get phrase list {phraselistId} from app {appId} version {versionId}.
        slots:
          phraselistId: path.phraselistId
          appId: path.appId
          versionId: path.versionId
      - text: Show the phrases in phrase list {phraselistId}.
        slots:
          phraselistId: path.phraselistId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/phraselists/{phraselistId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a phrase list's phrases, name or state
      effect: write
      questions:
      - Can I rename a phrase list or turn it off without deleting it?
      - How do I replace the phrases stored in an existing LUIS phrase list?
      instructions:
      - text: Rename phrase list {phraselistId} in app {appId} version {versionId} to {name}.
        slots:
          phraselistId: path.phraselistId
          appId: path.appId
          versionId: path.versionId
          name: requestBody.name
      - text: Set the phrases of phrase list {phraselistId} to {phrases}.
        slots:
          phraselistId: path.phraselistId
          phrases: requestBody.phrases
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/phraselists/{phraselistId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a phrase list feature
      effect: destructive
      questions:
      - Can I get rid of a phrase list I no longer need in a LUIS version?
      - Is deleting a phrase list feature from a LUIS version reversible?
      instructions:
      - text: Delete phrase list {phraselistId} from app {appId} version {versionId}.
        slots:
          phraselistId: path.phraselistId
          appId: path.appId
          versionId: path.versionId
      - text: Remove the phrase list feature {phraselistId}.
        slots:
          phraselistId: path.phraselistId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/example'].post
  update:
    x-apievangelist-phrasing:
      intent: Add one labeled example utterance
      effect: write
      questions:
      - How do I teach LUIS a single new example utterance with its intent?
      - Can I label entities in an example utterance when I add it?
      instructions:
      - text: Add the example utterance {text} labeled as intent {intentName} to app {appId} version {versionId}.
        slots:
          text: requestBody.text
          intentName: requestBody.intentName
          appId: path.appId
          versionId: path.versionId
      - text: Label {text} as {intentName} in LUIS version {versionId}.
        slots:
          text: requestBody.text
          intentName: requestBody.intentName
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/examples'].get
  update:
    x-apievangelist-phrasing:
      intent: List example utterances for review
      effect: read
      questions:
      - Which labeled example utterances does a LUIS version already contain?
      - Can I review example utterances a page at a time?
      instructions:
      - text: List the example utterances in app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show {take} labeled utterances from LUIS version {versionId} starting at {skip}.
        slots:
          take: query.take
          versionId: path.versionId
          skip: query.skip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/examples'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a batch of labeled example utterances
      effect: write
      questions:
      - Is there a bulk upload for many labeled utterances at once in LUIS?
      - How do I import a large set of training utterances into a LUIS version in one request?
      instructions:
      - text: Upload a batch of labeled utterances to app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Bulk-add these example utterances to LUIS version {versionId} of {appId}.
        slots:
          versionId: path.versionId
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/examples/{exampleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a labeled example utterance
      effect: destructive
      questions:
      - Is there a way to drop a mislabeled example utterance from LUIS?
      - Can I delete one training utterance by its ID?
      instructions:
      - text: Delete example utterance {exampleId} from app {appId} version {versionId}.
        slots:
          exampleId: path.exampleId
          appId: path.appId
          versionId: path.versionId
      - text: Remove labeled utterance {exampleId}.
        slots:
          exampleId: path.exampleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/intents'].get
  update:
    x-apievangelist-phrasing:
      intent: List intents in a LUIS app version
      effect: read
      questions:
      - What intents are defined in my LUIS app version?
      - Can I page through a long list of intents?
      instructions:
      - text: List the intents in app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show all intent models in LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/intents'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an intent to a LUIS app version
      effect: write
      questions:
      - What's needed to create a new intent in my LUIS model?
      - Can I add an intent like BookFlight to an existing version?
      instructions:
      - text: Add intent {name} to app {appId} version {versionId}.
        slots:
          name: requestBody.name
          appId: path.appId
          versionId: path.versionId
      - text: Create a new LUIS intent called {name} in version {versionId}.
        slots:
          name: requestBody.name
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities'].get
  update:
    x-apievangelist-phrasing:
      intent: List simple entities in a LUIS version
      effect: read
      questions:
      - Which machine-learned entities exist in my LUIS version?
      - Where can I see all simple entity extractors a version defines?
      instructions:
      - text: List the machine-learned entities in app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show the simple entity models in LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an entity extractor to a LUIS version
      effect: write
      questions:
      - How do I create a new machine-learned entity in LUIS?
      - Can I define child entities at the same time I add an entity?
      instructions:
      - text: Add entity {name} to app {appId} version {versionId}.
        slots:
          name: requestBody.name
          appId: path.appId
          versionId: path.versionId
      - text: Create entity extractor {name} with children {children} in LUIS version {versionId}.
        slots:
          name: requestBody.name
          children: requestBody.children
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/hierarchicalentities'].get
  update:
    x-apievangelist-phrasing:
      intent: List hierarchical entities in a LUIS version
      effect: read
      questions:
      - What hierarchical entities does my LUIS version have?
      - Can I list only the hierarchical entity models?
      instructions:
      - text: List hierarchical entities in app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show the hierarchical entity models of LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/compositeentities'].get
  update:
    x-apievangelist-phrasing:
      intent: List composite entities in a LUIS version
      effect: read
      questions:
      - Which composite entities are defined in my LUIS app version?
      - Is there a way to see only composite entity models?
      instructions:
      - text: List composite entities in app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show every composite entity in LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/closedlists'].get
  update:
    x-apievangelist-phrasing:
      intent: List list entities in a LUIS version
      effect: read
      questions:
      - Which list (closed list) entities are defined in my LUIS version?
      - Where do I find all the synonym-based list entities?
      instructions:
      - text: List the closed list entities in app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show closed-list entity models in LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/closedlists'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a list entity to a LUIS version
      effect: write
      questions:
      - How do I create a list entity with canonical values and synonyms?
      - Can I supply sublists when creating a new closed list entity?
      instructions:
      - text: Add list entity {name} with sublists {subLists} to app {appId} version {versionId}.
        slots:
          name: requestBody.name
          subLists: requestBody.subLists
          appId: path.appId
          versionId: path.versionId
      - text: Create a closed list entity called {name} in LUIS version {versionId}.
        slots:
          name: requestBody.name
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/prebuilts'].get
  update:
    x-apievangelist-phrasing:
      intent: List prebuilt entities added to a version
      effect: read
      questions:
      - Which prebuilt entities have I already added to my LUIS version?
      - Can I page through the prebuilt entity extractors in a version?
      instructions:
      - text: List prebuilt entities added to app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show which prebuilt entities version {versionId} currently uses.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/prebuilts'].post
  update:
    x-apievangelist-phrasing:
      intent: Add prebuilt entities to a LUIS version
      effect: write
      questions:
      - How do I add prebuilt entities like number or datetime to my LUIS app?
      - Can I add several prebuilt entities to a version in one request?
      instructions:
      - text: Add prebuilt entities to app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Attach the datetime and number prebuilt entities to LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/listprebuilts'].get
  update:
    x-apievangelist-phrasing:
      intent: List prebuilt entities available to add
      effect: read
      questions:
      - Which prebuilt entities are available for my LUIS version's culture?
      - What prebuilt entity types could I still add to this version?
      instructions:
      - text: List the prebuilt entities available for app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show the catalog of prebuilt entities I can add to LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/models'].get
  update:
    x-apievangelist-phrasing:
      intent: List all intent and entity models in a version
      effect: read
      questions:
      - Can I get every intent and entity model of a LUIS version in one call?
      - What models, of all types, make up my LUIS app version?
      instructions:
      - text: List all intent and entity models in app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show every model in LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/models/{modelId}/examples'].get
  update:
    x-apievangelist-phrasing:
      intent: List example utterances for one model
      effect: read
      questions:
      - Which example utterances are labeled for a specific intent or entity?
      - How can I see the training examples tied to one LUIS model?
      instructions:
      - text: List example utterances for model {modelId} in app {appId} version {versionId}.
        slots:
          modelId: path.modelId
          appId: path.appId
          versionId: path.versionId
      - text: Show the labeled examples of intent or entity {modelId}.
        slots:
          modelId: path.modelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/intents/{intentId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an intent's details
      effect: read
      questions:
      - Can I fetch one intent in my LUIS app by its ID?
      - What information does LUIS return about a single intent?
      instructions:
      - text: Get intent {intentId} from app {appId} version {versionId}.
        slots:
          intentId: path.intentId
          appId: path.appId
          versionId: path.versionId
      - text: Show details of LUIS intent {intentId}.
        slots:
          intentId: path.intentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/intents/{intentId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename an intent
      effect: write
      questions:
      - Can I rename an intent without losing its utterances?
      - Is it possible to change the name of an existing LUIS intent?
      instructions:
      - text: Rename intent {intentId} in app {appId} version {versionId} to {name}.
        slots:
          intentId: path.intentId
          appId: path.appId
          versionId: path.versionId
          name: requestBody.name
      - text: Change the name of LUIS intent {intentId} to {name}.
        slots:
          intentId: path.intentId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/intents/{intentId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an intent
      effect: destructive
      questions:
      - When I delete an intent, can I also remove its example utterances?
      - Is an intent removable from a LUIS version once it has training data?
      instructions:
      - text: Delete intent {intentId} from app {appId} version {versionId}.
        slots:
          intentId: path.intentId
          appId: path.appId
          versionId: path.versionId
      - text: Delete intent {intentId} and its utterances, with deleteUtterances set to {deleteUtterances}.
        slots:
          intentId: path.intentId
          deleteUtterances: query.deleteUtterances
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities/{entityId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an entity's details
      effect: read
      questions:
      - Can I fetch a single machine-learned entity by its ID?
      - What does LUIS return about a single entity model, including its children?
      instructions:
      - text: Get entity {entityId} from app {appId} version {versionId}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show details of LUIS entity {entityId}.
        slots:
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities/{entityId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an entity or entity child
      effect: destructive
      questions:
      - Can I delete a machine-learned entity or just one of its children?
      - How do I remove an entity from a LUIS version?
      instructions:
      - text: Delete entity {entityId} from app {appId} version {versionId}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove the entity or child entity {entityId}.
        slots:
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities/{entityId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename an entity or change a child's instanceOf
      effect: write
      questions:
      - Can I rename a machine-learned entity after creating it?
      - How do I change which model a child entity is an instance of?
      instructions:
      - text: Rename machine-learned entity {entityId} in app {appId} version {versionId} to {name}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
          name: requestBody.name
      - text: Set child entity {entityId} to be an instance of {instanceOf}.
        slots:
          entityId: path.entityId
          instanceOf: requestBody.instanceOf
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/intents/{intentId}/features'].get
  update:
    x-apievangelist-phrasing:
      intent: List features used by an intent
      effect: read
      questions:
      - Which features, like phrase lists or models, is an intent using?
      - What feature relations are attached to one intent?
      instructions:
      - text: List the features used by intent {intentId} in app {appId} version {versionId}.
        slots:
          intentId: path.intentId
          appId: path.appId
          versionId: path.versionId
      - text: Show feature relations on LUIS intent {intentId}.
        slots:
          intentId: path.intentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/intents/{intentId}/features'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace all features used by an intent
      effect: write
      questions:
      - Can I overwrite an intent's whole set of feature relations at once?
      - How do I replace, rather than add to, the features an intent uses?
      instructions:
      - text: Replace the feature relations of intent {intentId} in app {appId} version {versionId}.
        slots:
          intentId: path.intentId
          appId: path.appId
          versionId: path.versionId
      - text: Overwrite all features used by LUIS intent {intentId}.
        slots:
          intentId: path.intentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/intents/{intentId}/features'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a feature relation to an intent
      effect: write
      questions:
      - How do I attach a phrase list as a feature to one intent?
      - Can I mark a feature as required when adding it to an intent?
      instructions:
      - text: Add feature {featureName} to intent {intentId} in app {appId} version {versionId}.
        slots:
          featureName: requestBody.featureName
          intentId: path.intentId
          appId: path.appId
          versionId: path.versionId
      - text: Use model {modelName} as a feature of intent {intentId}.
        slots:
          modelName: requestBody.modelName
          intentId: path.intentId
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (133 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/overlays/microsoft-azure-apps-api-phrasing-overlay.yaml