# 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'
- target: $.paths['/apps/{appId}/versions/{versionId}/intents/{intentId}/features'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a feature relation from an intent
      effect: destructive
      questions:
      - How do I detach one feature from an intent without touching the others?
      - Can I remove a model used as a feature by an intent?
      instructions:
      - text: Remove feature {featureName} from intent {intentId} in app {appId} version {versionId}.
        slots:
          featureName: requestBody.featureName
          intentId: path.intentId
          appId: path.appId
          versionId: path.versionId
      - text: Detach model {modelName} as a feature of intent {intentId}.
        slots:
          modelName: requestBody.modelName
          intentId: path.intentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities/{entityId}/features'].get
  update:
    x-apievangelist-phrasing:
      intent: List features used by an entity
      effect: read
      questions:
      - Which features does a machine-learned entity currently use?
      - Where can I inspect the feature relations on one entity?
      instructions:
      - text: List the features used by entity {entityId} in app {appId} version {versionId}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show feature relations on LUIS entity {entityId}.
        slots:
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities/{entityId}/features'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace all features used by an entity
      effect: write
      questions:
      - Can I overwrite every feature relation on an entity in one call?
      - How do I reset the full feature set of a machine-learned entity?
      instructions:
      - text: Replace the feature relations of entity {entityId} in app {appId} version {versionId}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Overwrite all features used by LUIS entity {entityId}.
        slots:
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities/{entityId}/features'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a feature relation to an entity
      effect: write
      questions:
      - How do I attach a phrase list as a feature to a machine-learned entity?
      - Can a feature added to an entity be marked required?
      instructions:
      - text: Add feature {featureName} to entity {entityId} in app {appId} version {versionId}.
        slots:
          featureName: requestBody.featureName
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Use model {modelName} as a feature of entity {entityId}.
        slots:
          modelName: requestBody.modelName
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities/{entityId}/features'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a feature relation from an entity
      effect: destructive
      questions:
      - Is it possible to detach a single feature from an entity?
      - Can I stop an entity from using a particular model as a feature?
      instructions:
      - text: Remove feature {featureName} from entity {entityId} in app {appId} version {versionId}.
        slots:
          featureName: requestBody.featureName
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Detach model {modelName} as a feature of entity {entityId}.
        slots:
          modelName: requestBody.modelName
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/hierarchicalentities/{hEntityId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a hierarchical entity
      effect: read
      questions:
      - What children does one hierarchical entity contain?
      - What does LUIS return for a single hierarchical entity model?
      instructions:
      - text: Get hierarchical entity {hEntityId} from app {appId} version {versionId}.
        slots:
          hEntityId: path.hEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Show details of hierarchical entity {hEntityId}.
        slots:
          hEntityId: path.hEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/hierarchicalentities/{hEntityId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a hierarchical entity
      effect: destructive
      questions:
      - How do I remove a hierarchical entity from my LUIS version?
      - Does deleting a hierarchical entity take its children with it?
      instructions:
      - text: Delete hierarchical entity {hEntityId} from app {appId} version {versionId}.
        slots:
          hEntityId: path.hEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove the hierarchical entity model {hEntityId}.
        slots:
          hEntityId: path.hEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/hierarchicalentities/{hEntityId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a hierarchical entity
      effect: write
      questions:
      - Can I rename a hierarchical entity model?
      - Is there a way to change a hierarchical entity's name in place?
      instructions:
      - text: Rename hierarchical entity {hEntityId} in app {appId} version {versionId} to {name}.
        slots:
          hEntityId: path.hEntityId
          appId: path.appId
          versionId: path.versionId
          name: requestBody.name
      - text: Change the name of hierarchical entity {hEntityId} to {name}.
        slots:
          hEntityId: path.hEntityId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/compositeentities/{cEntityId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a composite entity
      effect: read
      questions:
      - Which child entities make up one particular composite entity?
      - What does LUIS return for a single composite entity?
      instructions:
      - text: Get composite entity {cEntityId} from app {appId} version {versionId}.
        slots:
          cEntityId: path.cEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Show details of composite entity {cEntityId}.
        slots:
          cEntityId: path.cEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/compositeentities/{cEntityId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a composite entity
      effect: write
      questions:
      - Can I rename a composite entity or change its children?
      - How do I redefine which entities make up a composite entity?
      instructions:
      - text: Update composite entity {cEntityId} in app {appId} version {versionId} with children {children}.
        slots:
          cEntityId: path.cEntityId
          appId: path.appId
          versionId: path.versionId
          children: requestBody.children
      - text: Rename composite entity {cEntityId} to {name}.
        slots:
          cEntityId: path.cEntityId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/compositeentities/{cEntityId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a composite entity
      effect: destructive
      questions:
      - How do I remove a composite entity from a LUIS version?
      - Can I delete a composite entity I no longer use?
      instructions:
      - text: Delete composite entity {cEntityId} from app {appId} version {versionId}.
        slots:
          cEntityId: path.cEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove the composite entity model {cEntityId}.
        slots:
          cEntityId: path.cEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/closedlists/{clEntityId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a list entity
      effect: read
      questions:
      - What canonical values and synonyms does one list entity hold?
      - What does LUIS return for a single closed list entity?
      instructions:
      - text: Get list entity {clEntityId} from app {appId} version {versionId}.
        slots:
          clEntityId: path.clEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Show the sublists of list entity {clEntityId}.
        slots:
          clEntityId: path.clEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/closedlists/{clEntityId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a list entity's name and sublists
      effect: write
      questions:
      - Can I overwrite all sublists of a list entity in one update?
      - How do I rename a list entity and reset its values?
      instructions:
      - text: Replace the sublists of list entity {clEntityId} in app {appId} version {versionId} with {subLists}.
        slots:
          clEntityId: path.clEntityId
          appId: path.appId
          versionId: path.versionId
          subLists: requestBody.subLists
      - text: Rename list entity {clEntityId} to {name}.
        slots:
          clEntityId: path.clEntityId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/closedlists/{clEntityId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a list entity
      effect: destructive
      questions:
      - Can a closed list entity be removed from my LUIS version?
      - Can I delete a list entity model entirely?
      instructions:
      - text: Delete list entity {clEntityId} from app {appId} version {versionId}.
        slots:
          clEntityId: path.clEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove the closed list entity {clEntityId}.
        slots:
          clEntityId: path.clEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/closedlists/{clEntityId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Append sublists to a list entity
      effect: write
      questions:
      - Can I add more canonical values to a list entity without replacing the existing ones?
      - How do I append a batch of sublists to a closed list?
      instructions:
      - text: Append sublists {subLists} to list entity {clEntityId} in app {appId} version {versionId}.
        slots:
          subLists: requestBody.subLists
          clEntityId: path.clEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Add these new values to closed list {clEntityId} without overwriting it.
        slots:
          clEntityId: path.clEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/prebuilts/{prebuiltId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a prebuilt entity added to a version
      effect: read
      questions:
      - Where can I read the details of a prebuilt entity I added to my LUIS version?
      - What details does LUIS keep for one prebuilt entity extractor?
      instructions:
      - text: Get prebuilt entity {prebuiltId} from app {appId} version {versionId}.
        slots:
          prebuiltId: path.prebuiltId
          appId: path.appId
          versionId: path.versionId
      - text: Show the prebuilt entity extractor {prebuiltId}.
        slots:
          prebuiltId: path.prebuiltId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/prebuilts/{prebuiltId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a prebuilt entity from a version
      effect: destructive
      questions:
      - How do I remove a prebuilt entity like datetime from my version?
      - Can I delete a prebuilt entity extractor I added by mistake?
      instructions:
      - text: Delete prebuilt entity {prebuiltId} from app {appId} version {versionId}.
        slots:
          prebuiltId: path.prebuiltId
          appId: path.appId
          versionId: path.versionId
      - text: Remove prebuilt extractor {prebuiltId}.
        slots:
          prebuiltId: path.prebuiltId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/closedlists/{clEntityId}/sublists/{subListId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update one sublist of a list entity
      effect: write
      questions:
      - Can I change the synonyms of just one value in a list entity?
      - How do I edit a single sublist's canonical form?
      instructions:
      - text: Update sublist {subListId} of list entity {clEntityId} in app {appId} version {versionId} to canonical form {canonicalForm}.
        slots:
          subListId: path.subListId
          clEntityId: path.clEntityId
          appId: path.appId
          versionId: path.versionId
          canonicalForm: requestBody.canonicalForm
      - text: Set the synonyms of sublist {subListId} to {list}.
        slots:
          subListId: path.subListId
          list: requestBody.list
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/closedlists/{clEntityId}/sublists/{subListId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one sublist of a list entity
      effect: destructive
      questions:
      - How do I remove a single value from a list entity?
      - Can I delete one sublist while keeping the rest of the closed list?
      instructions:
      - text: Delete sublist {subListId} from list entity {clEntityId} in app {appId} version {versionId}.
        slots:
          subListId: path.subListId
          clEntityId: path.clEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove value {subListId} from closed list {clEntityId}.
        slots:
          subListId: path.subListId
          clEntityId: path.clEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/intents/{intentId}/suggest'].get
  update:
    x-apievangelist-phrasing:
      intent: Suggest utterances to improve an intent
      effect: read
      questions:
      - Which endpoint utterances would most improve my intent's accuracy?
      - Can LUIS suggest example utterances for a weak intent?
      instructions:
      - text: Suggest utterances to improve intent {intentId} in app {appId} version {versionId}.
        slots:
          intentId: path.intentId
          appId: path.appId
          versionId: path.versionId
      - text: Get {take} suggested examples for LUIS intent {intentId}.
        slots:
          take: query.take
          intentId: path.intentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities/{entityId}/suggest'].get
  update:
    x-apievangelist-phrasing:
      intent: Suggest utterances to improve an entity
      effect: read
      questions:
      - Can LUIS suggest example utterances that would improve an entity's accuracy?
      - Which utterances should I label next to strengthen an entity?
      instructions:
      - text: Suggest utterances to improve entity {entityId} in app {appId} version {versionId}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Get {take} suggested examples for LUIS entity {entityId}.
        slots:
          take: query.take
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/'].get
  update:
    x-apievangelist-phrasing:
      intent: List my LUIS applications
      effect: read
      questions:
      - Which LUIS applications do I own?
      - Can I page through my language understanding apps a few at a time?
      instructions:
      - text: List all of my LUIS applications.
      - text: Show {take} of my LUIS apps, skipping the first {skip}.
        slots:
          take: query.take
          skip: query.skip
      method: generated
      generated: '2026-10-01'
- target: $.paths['/apps/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new LUIS application
      effect: write
      questions:
      - How do I create a new LUIS app for a given language?
      - What do I need to supply to start a brand new language understanding app?
      instructions:
      - text: Create a LUIS app named {name} for culture {culture}.
        slots:
          name: requestBody.name
          culture: requestBody.culture
      - text: Create LUIS app {name} in culture {culture} with description {description}.
        slots:
          name: requestBody.name
          culture: requestBody.culture
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/import'].post
  update:
    x-apievangelist-phrasing:
      intent: Import a LUIS application from JSON
      effect: write
      questions:
      - Can I import a whole LUIS application from an exported JSON file?
      - How do I recreate a LUIS app from its JSON definition?
      instructions:
      - text: Import this LUIS app JSON as a new application named {appName}.
        slots:
          appName: query.appName
      - text: Create a new LUIS app from the exported JSON with culture {culture}.
        slots:
          culture: requestBody.culture
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/assistants'].get
  update:
    x-apievangelist-phrasing:
      intent: Get prebuilt Cortana app endpoints
      effect: read
      questions:
      - Where are the endpoint URLs for the prebuilt Cortana apps?
      - Can I get the Cortana assistant application endpoints from LUIS?
      instructions:
      - text: List the endpoint URLs of the prebuilt Cortana applications.
      - text: Show me the Cortana prebuilt app endpoints.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/domains'].get
  update:
    x-apievangelist-phrasing:
      intent: List available LUIS app domains
      effect: read
      questions:
      - What application domains can I pick when creating a LUIS app?
      - Which domain values does LUIS accept for an app?
      instructions:
      - text: List the available LUIS application domains.
      - text: Show the domains I can assign to a new LUIS app.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/usagescenarios'].get
  update:
    x-apievangelist-phrasing:
      intent: List LUIS app usage scenarios
      effect: read
      questions:
      - What usage scenarios can a LUIS app be tagged with?
      - Which usage scenario values are valid for a LUIS application?
      instructions:
      - text: List the available LUIS usage scenarios.
      - text: Show usage scenario options for a new LUIS app.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/cultures'].get
  update:
    x-apievangelist-phrasing:
      intent: List supported LUIS cultures
      effect: read
      questions:
      - Which languages and locales does LUIS support?
      - Is my language available as a culture for a LUIS app?
      instructions:
      - text: List the cultures LUIS supports.
      - text: Show every language culture a LUIS app can be built in.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/querylogs'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a LUIS app's query logs
      effect: read
      questions:
      - Can I download what users actually sent to my LUIS endpoint last month?
      - Where do I get the endpoint query logs for a LUIS app?
      instructions:
      - text: Download the past month of query logs for LUIS app {appId}.
        slots:
          appId: path.appId
      - text: Export endpoint query logs of app {appId}.
        slots:
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a LUIS application's info
      effect: read
      questions:
      - What culture, description and active version does my LUIS app have?
      - Where do I read the basic info of one LUIS application?
      instructions:
      - text: Get the application info for LUIS app {appId}.
        slots:
          appId: path.appId
      - text: Show the name, culture and active version of LUIS app {appId}.
        slots:
          appId: path.appId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/apps/{appId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename or redescribe a LUIS application
      effect: write
      questions:
      - Can I rename a LUIS application after creating it?
      - How do I change the description shown for my LUIS app?
      instructions:
      - text: Rename LUIS app {appId} to {name}.
        slots:
          appId: path.appId
          name: requestBody.name
      - text: Set the description of LUIS app {appId} to {description}.
        slots:
          appId: path.appId
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/apps/{appId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a LUIS application
      effect: destructive
      questions:
      - How do I permanently delete a LUIS application and all its versions?
      - Can I force-delete a LUIS app that is still in use?
      instructions:
      - text: Delete LUIS application {appId}.
        slots:
          appId: path.appId
      - text: Force-delete LUIS app {appId} with force set to {force}.
        slots:
          appId: path.appId
          force: query.force
      method: generated
      generated: '2026-10-01'
- target: $.paths['/apps/{appId}/versions/{versionId}/clone'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a LUIS app version
      effect: write
      questions:
      - Can I copy an existing LUIS version into a new version to experiment?
      - How do I branch a LUIS app version before making changes?
      instructions:
      - text: Clone version {versionId} of app {appId} as new version {version}.
        slots:
          versionId: path.versionId
          appId: path.appId
          version: requestBody.version
      - text: Make a copy of LUIS version {versionId} named {version}.
        slots:
          versionId: path.versionId
          version: requestBody.version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/publish'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish a LUIS app version
      effect: write
      questions:
      - How do I publish a trained LUIS version to production or staging?
      - Can I publish to the staging slot instead of production?
      instructions:
      - text: Publish version {versionId} of LUIS app {appId}.
        slots:
          versionId: requestBody.versionId
          appId: path.appId
      - text: Publish LUIS app {appId} version {versionId} to staging with isStaging {isStaging}.
        slots:
          appId: path.appId
          versionId: requestBody.versionId
          isStaging: requestBody.isStaging
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List versions of a LUIS app
      effect: read
      questions:
      - Which versions exist for my LUIS application?
      - Can I page through all versions of a LUIS app?
      instructions:
      - text: List the versions of LUIS app {appId}.
        slots:
          appId: path.appId
      - text: Show {take} versions of app {appId}.
        slots:
          take: query.take
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a LUIS version's info
      effect: read
      questions:
      - When was a LUIS version created and last trained?
      - How many intents and entities does one version of my LUIS app have?
      instructions:
      - text: Get info for version {versionId} of LUIS app {appId}.
        slots:
          versionId: path.versionId
          appId: path.appId
      - text: Show created date, training status and counts for version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a LUIS app version
      effect: write
      questions:
      - Can I rename a version of my LUIS app?
      - How do I change the version ID of an existing LUIS version?
      instructions:
      - text: Rename version {versionId} of LUIS app {appId} to {version}.
        slots:
          versionId: path.versionId
          appId: path.appId
          version: requestBody.version
      - text: Change LUIS version label {versionId} to {version}.
        slots:
          versionId: path.versionId
          version: requestBody.version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a LUIS app version
      effect: destructive
      questions:
      - Is there a way to clean up an old version of my LUIS app?
      - Can I delete one LUIS version and keep the others?
      instructions:
      - text: Delete version {versionId} of LUIS app {appId}.
        slots:
          versionId: path.versionId
          appId: path.appId
      - text: Remove LUIS app version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/export'].get
  update:
    x-apievangelist-phrasing:
      intent: Export a LUIS version as JSON
      effect: read
      questions:
      - Can I export a LUIS app version to a JSON file for backup?
      - Where do I get the full model definition of a LUIS version as a file?
      instructions:
      - text: Export version {versionId} of LUIS app {appId} to JSON.
        slots:
          versionId: path.versionId
          appId: path.appId
      - text: Download the JSON definition of LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/train'].get
  update:
    x-apievangelist-phrasing:
      intent: Get training status of a LUIS version
      effect: read
      questions:
      - Has my LUIS version finished training yet?
      - How do I check whether training succeeded for every model in a version?
      instructions:
      - text: Get training status for version {versionId} of LUIS app {appId}.
        slots:
          versionId: path.versionId
          appId: path.appId
      - text: Check if LUIS version {versionId} is done training.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/train'].post
  update:
    x-apievangelist-phrasing:
      intent: Start training a LUIS version
      effect: write
      questions:
      - What starts training after I change my LUIS model?
      - Is training a LUIS version asynchronous, and can I choose a training mode?
      instructions:
      - text: Train version {versionId} of LUIS app {appId}.
        slots:
          versionId: path.versionId
          appId: path.appId
      - text: Start training LUIS version {versionId} in mode {mode}.
        slots:
          versionId: path.versionId
          mode: query.mode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/import'].post
  update:
    x-apievangelist-phrasing:
      intent: Import a new version into a LUIS app
      effect: write
      questions:
      - Can I import a JSON model as a new version of an existing LUIS app?
      - How do I load an exported version back into the same application?
      instructions:
      - text: Import this JSON as a new version of LUIS app {appId}.
        slots:
          appId: path.appId
      - text: Import a version into app {appId} with version ID {versionId}.
        slots:
          appId: path.appId
          versionId: requestBody.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a LUIS app's settings
      effect: read
      questions:
      - Is my LUIS application public or private?
      - Where can I read the app-level settings of a LUIS app?
      instructions:
      - text: Read the app-level settings of LUIS app {appId}.
        slots:
          appId: path.appId
      - text: Show whether LUIS app {appId} is public.
        slots:
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/settings'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a LUIS app's settings
      effect: write
      questions:
      - How do I make my LUIS application public?
      - Can I switch a LUIS app back to private?
      instructions:
      - text: Set LUIS app {appId} public flag to {public}.
        slots:
          appId: path.appId
          public: requestBody.public
      - text: Make LUIS app {appId} private.
        slots:
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/publishsettings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a LUIS app's publish settings
      effect: read
      questions:
      - Are sentiment analysis, speech or spell checking enabled for my published LUIS app?
      - Where do I read the publish-time options of a LUIS app?
      instructions:
      - text: Show sentiment, speech and spell-check publish options for LUIS app {appId}.
        slots:
          appId: path.appId
      - text: Show whether spell checking is on for published app {appId}.
        slots:
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/publishsettings'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a LUIS app's publish settings
      effect: write
      questions:
      - How do I turn on sentiment analysis for my published LUIS app?
      - Can I enable speech priming or the spell checker at publish time?
      instructions:
      - text: Enable sentiment analysis on LUIS app {appId} with {sentimentAnalysis}.
        slots:
          appId: path.appId
          sentimentAnalysis: requestBody.sentimentAnalysis
      - text: Set spell checker to {spellChecker} for app {appId}.
        slots:
          spellChecker: requestBody.spellChecker
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/suggest'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an unlabelled suggested utterance
      effect: destructive
      questions:
      - Can I discard an unlabelled utterance from the review suggestions?
      - Can I delete an endpoint utterance I do not want to label?
      instructions:
      - text: Delete an unlabelled utterance from version {versionId} of app {appId}.
        slots:
          versionId: path.versionId
          appId: path.appId
      - text: Discard this suggested utterance in LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/endpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List a LUIS app's endpoint regions and URLs
      effect: read
      questions:
      - Which regions and endpoint URLs can my LUIS app be reached at?
      - Where is my LUIS app deployed?
      instructions:
      - text: List the endpoint regions and URLs for LUIS app {appId}.
        slots:
          appId: path.appId
      - text: Show deployment endpoints of app {appId}.
        slots:
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/closedlists/{clEntityId}/sublists'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a sublist to a list entity
      effect: write
      questions:
      - How do I add a single new canonical value with synonyms to a list entity?
      - Can I add one sublist at a time to a closed list?
      instructions:
      - text: Add value {canonicalForm} with synonyms {list} to list entity {clEntityId} in app {appId} version {versionId}.
        slots:
          canonicalForm: requestBody.canonicalForm
          list: requestBody.list
          clEntityId: path.clEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Create a sublist {canonicalForm} in closed list {clEntityId}.
        slots:
          canonicalForm: requestBody.canonicalForm
          clEntityId: path.clEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/customprebuiltdomains'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a customizable prebuilt domain to a version
      effect: write
      questions:
      - Can I add a whole prebuilt domain, with all its intents and entities, to my version?
      - How do I bring a domain like Calendar into an existing LUIS version?
      instructions:
      - text: Add prebuilt domain {domainName} to app {appId} version {versionId}.
        slots:
          domainName: requestBody.domainName
          appId: path.appId
          versionId: path.versionId
      - text: Import all models of domain {domainName} into LUIS version {versionId}.
        slots:
          domainName: requestBody.domainName
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/customprebuiltintents'].get
  update:
    x-apievangelist-phrasing:
      intent: List customizable prebuilt intents in a version
      effect: read
      questions:
      - Which prebuilt domain intents have I added to my LUIS version?
      - Where do I see the customizable prebuilt intents in a version?
      instructions:
      - text: List customizable prebuilt intents in app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show prebuilt domain intents used by LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/customprebuiltintents'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a customizable prebuilt intent
      effect: write
      questions:
      - How do I add a single prebuilt domain intent to my LUIS version?
      - Can I pick one intent from a prebuilt domain instead of the whole domain?
      instructions:
      - text: Add prebuilt intent {modelName} from domain {domainName} to app {appId} version {versionId}.
        slots:
          modelName: requestBody.modelName
          domainName: requestBody.domainName
          appId: path.appId
          versionId: path.versionId
      - text: Use the {domainName} domain intent {modelName} in LUIS version {versionId}.
        slots:
          domainName: requestBody.domainName
          modelName: requestBody.modelName
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/customprebuiltentities'].get
  update:
    x-apievangelist-phrasing:
      intent: List customizable prebuilt entities in a version
      effect: read
      questions:
      - Which prebuilt domain entities does my LUIS version use?
      - Where can I see customizable prebuilt entity models in a version?
      instructions:
      - text: List customizable prebuilt entities in app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show prebuilt domain entities used by LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/customprebuiltentities'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a customizable prebuilt entity
      effect: write
      questions:
      - Is it possible to add only one entity model from a prebuilt domain to my version?
      - Can I take one entity from a prebuilt domain without its intents?
      instructions:
      - text: Add prebuilt entity {modelName} from domain {domainName} to app {appId} version {versionId}.
        slots:
          modelName: requestBody.modelName
          domainName: requestBody.domainName
          appId: path.appId
          versionId: path.versionId
      - text: Use the {domainName} domain entity {modelName} in LUIS version {versionId}.
        slots:
          domainName: requestBody.domainName
          modelName: requestBody.modelName
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/customprebuiltmodels'].get
  update:
    x-apievangelist-phrasing:
      intent: List all prebuilt domain models in a version
      effect: read
      questions:
      - What prebuilt domain intents and entities together does my version use?
      - Can I see every customizable prebuilt model in a LUIS version in one list?
      instructions:
      - text: List all prebuilt domain models in app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show prebuilt intent and entity models of LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/customprebuiltdomains/{domainName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a prebuilt domain's models from a version
      effect: destructive
      questions:
      - Can I strip out all models from a prebuilt domain I added?
      - Can I undo adding a prebuilt domain to a LUIS version?
      instructions:
      - text: Remove prebuilt domain {domainName} from app {appId} version {versionId}.
        slots:
          domainName: path.domainName
          appId: path.appId
          versionId: path.versionId
      - text: Delete all {domainName} domain models from LUIS version {versionId}.
        slots:
          domainName: path.domainName
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/customprebuiltdomains'].get
  update:
    x-apievangelist-phrasing:
      intent: List prebuilt domains for all cultures
      effect: read
      questions:
      - Which prebuilt domains does LUIS offer across all languages?
      - What customizable prebuilt domains exist in LUIS?
      instructions:
      - text: List all available LUIS prebuilt domains for every culture.
      - text: Show the full catalog of customizable prebuilt domains.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/customprebuiltdomains'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a LUIS app from a prebuilt domain
      effect: write
      questions:
      - Can I start a brand new LUIS app from a prebuilt domain?
      - How do I create an application that is prebuilt from a domain such as Calendar?
      instructions:
      - text: Create a new LUIS app from prebuilt domain {domainName} in culture {culture}.
        slots:
          domainName: requestBody.domainName
          culture: requestBody.culture
      - text: Spin up an application based on the {domainName} domain.
        slots:
          domainName: requestBody.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/customprebuiltdomains/{culture}'].get
  update:
    x-apievangelist-phrasing:
      intent: List prebuilt domains for one culture
      effect: read
      questions:
      - Which prebuilt domains are available in a specific language?
      - Are prebuilt domains offered for my culture?
      instructions:
      - text: List prebuilt domains available for culture {culture}.
        slots:
          culture: path.culture
      - text: Show LUIS prebuilt domains in {culture}.
        slots:
          culture: path.culture
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities/{entityId}/children'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a child to an entity
      effect: write
      questions:
      - How do I add a child entity under an existing machine-learned entity?
      - Can a new child entity be an instance of another model?
      instructions:
      - text: Add child {name} to machine-learned entity {entityId} in app {appId} version {versionId}.
        slots:
          name: requestBody.name
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Create child entity {name} under {entityId} as an instance of {instanceOf}.
        slots:
          name: requestBody.name
          entityId: path.entityId
          instanceOf: requestBody.instanceOf
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/hierarchicalentities/{hEntityId}/children/{hChildId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a hierarchical entity child
      effect: read
      questions:
      - How do I look up one child of a hierarchical entity?
      - What does LUIS return about a hierarchical entity's child?
      instructions:
      - text: Get child {hChildId} of hierarchical entity {hEntityId} in app {appId} version {versionId}.
        slots:
          hChildId: path.hChildId
          hEntityId: path.hEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Show hierarchical child {hChildId}.
        slots:
          hChildId: path.hChildId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/hierarchicalentities/{hEntityId}/children/{hChildId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a hierarchical entity child
      effect: destructive
      questions:
      - Can I remove a single child from a hierarchical entity?
      - How do I delete one hierarchical entity child extractor?
      instructions:
      - text: Delete child {hChildId} from hierarchical entity {hEntityId} in app {appId} version {versionId}.
        slots:
          hChildId: path.hChildId
          hEntityId: path.hEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove hierarchical child {hChildId}.
        slots:
          hChildId: path.hChildId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/hierarchicalentities/{hEntityId}/children/{hChildId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a hierarchical entity child
      effect: write
      questions:
      - Can I rename one child of a hierarchical entity?
      - How do I change a hierarchical child's name?
      instructions:
      - text: Rename child {hChildId} of hierarchical entity {hEntityId} in app {appId} version {versionId} to {name}.
        slots:
          hChildId: path.hChildId
          hEntityId: path.hEntityId
          appId: path.appId
          versionId: path.versionId
          name: requestBody.name
      - text: Change hierarchical child {hChildId} name to {name}.
        slots:
          hChildId: path.hChildId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/compositeentities/{cEntityId}/children'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a child to a composite entity
      effect: write
      questions:
      - How do I add another child entity to a composite entity?
      - Can I extend a composite entity with a new child?
      instructions:
      - text: Add child {name} to composite entity {cEntityId} in app {appId} version {versionId}.
        slots:
          name: requestBody.name
          cEntityId: path.cEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Put entity {name} inside composite {cEntityId}.
        slots:
          name: requestBody.name
          cEntityId: path.cEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/compositeentities/{cEntityId}/children/{cChildId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a composite entity child
      effect: destructive
      questions:
      - Can I remove one child from a composite entity?
      - How do I delete a composite entity extractor child?
      instructions:
      - text: Delete child {cChildId} from composite entity {cEntityId} in app {appId} version {versionId}.
        slots:
          cChildId: path.cChildId
          cEntityId: path.cEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove composite child {cChildId}.
        slots:
          cChildId: path.cChildId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/regexentities'].get
  update:
    x-apievangelist-phrasing:
      intent: List regular expression entities
      effect: read
      questions:
      - Which regex entities are defined in my LUIS version?
      - Can I page through regular expression entity models?
      instructions:
      - text: List regex entities in app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show regular expression entity models of LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/regexentities'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a regular expression entity
      effect: write
      questions:
      - How do I add an entity that matches a regular expression in LUIS?
      - Can I extract order numbers with a regex entity?
      instructions:
      - text: Create regex entity {name} with pattern {regexPattern} in app {appId} version {versionId}.
        slots:
          name: requestBody.name
          regexPattern: requestBody.regexPattern
          appId: path.appId
          versionId: path.versionId
      - text: Add a regular expression entity {name} matching {regexPattern}.
        slots:
          name: requestBody.name
          regexPattern: requestBody.regexPattern
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities'].get
  update:
    x-apievangelist-phrasing:
      intent: List Pattern.any entities
      effect: read
      questions:
      - Which Pattern.any entities exist in my LUIS version?
      - Can I page through my Pattern.any entity models?
      instructions:
      - text: List Pattern.any entities in app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show Pattern.any entity models of LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Pattern.any entity
      effect: write
      questions:
      - How do I create a Pattern.any entity for free-form text in patterns?
      - Can I give a new Pattern.any entity an explicit list of exceptions?
      instructions:
      - text: Create Pattern.any entity {name} in app {appId} version {versionId}.
        slots:
          name: requestBody.name
          appId: path.appId
          versionId: path.versionId
      - text: Add Pattern.any entity {name} with explicit list {explicitList}.
        slots:
          name: requestBody.name
          explicitList: requestBody.explicitList
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities/{entityId}/roles'].get
  update:
    x-apievangelist-phrasing:
      intent: List roles of an entity
      effect: read
      questions:
      - What roles are defined on a machine-learned entity?
      - How do I see the roles of a simple entity?
      instructions:
      - text: List roles of machine-learned entity {entityId} in app {appId} version {versionId}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show the roles on machine-learned entity {entityId}.
        slots:
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities/{entityId}/roles'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a role to an entity
      effect: write
      questions:
      - How do I add a role, like origin or destination, to a machine-learned entity?
      - Can one simple entity have multiple roles?
      instructions:
      - text: Add role {name} to machine-learned entity {entityId} in app {appId} version {versionId}.
        slots:
          name: requestBody.name
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Create role {name} on machine-learned entity {entityId}.
        slots:
          name: requestBody.name
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/prebuilts/{entityId}/roles'].get
  update:
    x-apievangelist-phrasing:
      intent: List roles of a prebuilt entity
      effect: read
      questions:
      - What roles are defined on a prebuilt entity in my version?
      - How do I see roles on the datetime prebuilt entity?
      instructions:
      - text: List roles of prebuilt entity {entityId} in app {appId} version {versionId}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show the roles on prebuilt {entityId}.
        slots:
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/prebuilts/{entityId}/roles'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a role to a prebuilt entity
      effect: write
      questions:
      - Can I add a role such as startDate to a prebuilt entity?
      - How do I give a prebuilt entity a named role?
      instructions:
      - text: Add role {name} to prebuilt entity {entityId} in app {appId} version {versionId}.
        slots:
          name: requestBody.name
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Create role {name} on prebuilt {entityId}.
        slots:
          name: requestBody.name
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/closedlists/{entityId}/roles'].get
  update:
    x-apievangelist-phrasing:
      intent: List roles of a list entity
      effect: read
      questions:
      - What roles exist on a closed list entity?
      - How do I see the roles of a list entity?
      instructions:
      - text: List roles of closed list entity {entityId} in app {appId} version {versionId}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show the roles on closed list {entityId}.
        slots:
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/closedlists/{entityId}/roles'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a role to a list entity
      effect: write
      questions:
      - Can I add a role to a closed list entity?
      - How do I give a list entity a role like fromCity?
      instructions:
      - text: Add role {name} to closed list entity {entityId} in app {appId} version {versionId}.
        slots:
          name: requestBody.name
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Create role {name} on closed list {entityId}.
        slots:
          name: requestBody.name
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/regexentities/{entityId}/roles'].get
  update:
    x-apievangelist-phrasing:
      intent: List roles of a regex entity
      effect: read
      questions:
      - What roles are defined on a regular expression entity?
      - How do I see a regex entity's roles?
      instructions:
      - text: List roles of regex entity {entityId} in app {appId} version {versionId}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show the roles on regular expression entity {entityId}.
        slots:
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/regexentities/{entityId}/roles'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a role to a regex entity
      effect: write
      questions:
      - Can I add a role to a regular expression entity?
      - How do I give a regex entity a named role?
      instructions:
      - text: Add role {name} to regex entity {entityId} in app {appId} version {versionId}.
        slots:
          name: requestBody.name
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Create role {name} on regular expression entity {entityId}.
        slots:
          name: requestBody.name
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/compositeentities/{cEntityId}/roles'].get
  update:
    x-apievangelist-phrasing:
      intent: List roles of a composite entity
      effect: read
      questions:
      - What roles exist on a composite entity?
      - How do I see the roles defined for a composite entity?
      instructions:
      - text: List roles of composite entity {cEntityId} in app {appId} version {versionId}.
        slots:
          cEntityId: path.cEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Show the roles on composite {cEntityId}.
        slots:
          cEntityId: path.cEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/compositeentities/{cEntityId}/roles'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a role to a composite entity
      effect: write
      questions:
      - Can I add a role to a composite entity?
      - How do I give a composite entity a named role?
      instructions:
      - text: Add role {name} to composite entity {cEntityId} in app {appId} version {versionId}.
        slots:
          name: requestBody.name
          cEntityId: path.cEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Create role {name} on composite {cEntityId}.
        slots:
          name: requestBody.name
          cEntityId: path.cEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities/{entityId}/roles'].get
  update:
    x-apievangelist-phrasing:
      intent: List roles of a Pattern.any entity
      effect: read
      questions:
      - What roles exist on a Pattern.any entity?
      - How do I see the roles defined for a Pattern.any entity?
      instructions:
      - text: List roles of Pattern.any entity {entityId} in app {appId} version {versionId}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show the roles on Pattern.any {entityId}.
        slots:
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities/{entityId}/roles'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a role to a Pattern.any entity
      effect: write
      questions:
      - Can I add a role to a Pattern.any entity?
      - How do I give a Pattern.any entity a named role?
      instructions:
      - text: Add role {name} to Pattern.any entity {entityId} in app {appId} version {versionId}.
        slots:
          name: requestBody.name
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Create role {name} on Pattern.any {entityId}.
        slots:
          name: requestBody.name
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/hierarchicalentities/{hEntityId}/roles'].get
  update:
    x-apievangelist-phrasing:
      intent: List roles of a hierarchical entity
      effect: read
      questions:
      - What roles exist on a hierarchical entity?
      - How do I see the roles defined for a hierarchical entity?
      instructions:
      - text: List roles of hierarchical entity {hEntityId} in app {appId} version {versionId}.
        slots:
          hEntityId: path.hEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Show the roles on hierarchical {hEntityId}.
        slots:
          hEntityId: path.hEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/hierarchicalentities/{hEntityId}/roles'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a role to a hierarchical entity
      effect: write
      questions:
      - Can I add a role to a hierarchical entity?
      - How do I give a hierarchical entity a named role?
      instructions:
      - text: Add role {name} to hierarchical entity {hEntityId} in app {appId} version {versionId}.
        slots:
          name: requestBody.name
          hEntityId: path.hEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Create role {name} on hierarchical {hEntityId}.
        slots:
          name: requestBody.name
          hEntityId: path.hEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/customprebuiltentities/{entityId}/roles'].get
  update:
    x-apievangelist-phrasing:
      intent: List roles of a prebuilt domain entity
      effect: read
      questions:
      - What roles exist on a customizable prebuilt domain entity?
      - How do I see roles on an entity that came from a prebuilt domain?
      instructions:
      - text: List roles of domain entity {entityId} in app {appId} version {versionId}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show the roles on custom prebuilt entity {entityId}.
        slots:
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/customprebuiltentities/{entityId}/roles'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a role to a prebuilt domain entity
      effect: write
      questions:
      - Can I add a role to an entity from a prebuilt domain?
      - How do I give a customizable prebuilt domain entity a role?
      instructions:
      - text: Add role {name} to domain entity {entityId} in app {appId} version {versionId}.
        slots:
          name: requestBody.name
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Create role {name} on custom prebuilt entity {entityId}.
        slots:
          name: requestBody.name
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities/{entityId}/explicitlist'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Pattern.any entity's explicit list
      effect: read
      questions:
      - What items are on the explicit list of a Pattern.any entity?
      - How do I see the exceptions defined for a Pattern.any entity?
      instructions:
      - text: Get the explicit list of Pattern.any entity {entityId} in app {appId} version {versionId}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show every explicit list item of Pattern.any {entityId}.
        slots:
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities/{entityId}/explicitlist'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an item to a Pattern.any explicit list
      effect: write
      questions:
      - How do I add an exception phrase to a Pattern.any entity's explicit list?
      - Can I append one item to a Pattern.any explicit list?
      instructions:
      - text: Add {explicitListItem} to the explicit list of Pattern.any entity {entityId} in app {appId} version {versionId}.
        slots:
          explicitListItem: requestBody.explicitListItem
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Append explicit list item {explicitListItem} to Pattern.any {entityId}.
        slots:
          explicitListItem: requestBody.explicitListItem
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/regexentities/{regexEntityId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a regular expression entity
      effect: read
      questions:
      - How do I look up one regex entity and its pattern?
      - What pattern does a given regular expression entity use?
      instructions:
      - text: Get regex entity {regexEntityId} from app {appId} version {versionId}.
        slots:
          regexEntityId: path.regexEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Show the pattern of regular expression entity {regexEntityId}.
        slots:
          regexEntityId: path.regexEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/regexentities/{regexEntityId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a regular expression entity
      effect: write
      questions:
      - Can I change the regex pattern of an existing entity?
      - How do I rename a regular expression entity?
      instructions:
      - text: Set the pattern of regex entity {regexEntityId} in app {appId} version {versionId} to {regexPattern}.
        slots:
          regexEntityId: path.regexEntityId
          appId: path.appId
          versionId: path.versionId
          regexPattern: requestBody.regexPattern
      - text: Rename regular expression entity {regexEntityId} to {name}.
        slots:
          regexEntityId: path.regexEntityId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/regexentities/{regexEntityId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a regular expression entity
      effect: destructive
      questions:
      - How do I remove a regex entity from my LUIS version?
      - Can I delete a regular expression entity model?
      instructions:
      - text: Delete regex entity {regexEntityId} from app {appId} version {versionId}.
        slots:
          regexEntityId: path.regexEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove regular expression entity {regexEntityId}.
        slots:
          regexEntityId: path.regexEntityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities/{entityId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Pattern.any entity
      effect: read
      questions:
      - How do I look up one Pattern.any entity by ID?
      - What does LUIS return for a single Pattern.any entity?
      instructions:
      - text: Get Pattern.any entity {entityId} from app {appId} version {versionId}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show details of Pattern.any entity {entityId}.
        slots:
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities/{entityId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Pattern.any entity
      effect: write
      questions:
      - Can I rename a Pattern.any entity or replace its explicit list?
      - How do I overwrite a Pattern.any entity's definition?
      instructions:
      - text: Rename Pattern.any entity {entityId} in app {appId} version {versionId} to {name}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
          name: requestBody.name
      - text: Replace the explicit list of Pattern.any {entityId} with {explicitList}.
        slots:
          entityId: path.entityId
          explicitList: requestBody.explicitList
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities/{entityId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Pattern.any entity
      effect: destructive
      questions:
      - How do I remove a Pattern.any entity from my LUIS version?
      - Can I delete a Pattern.any entity model?
      instructions:
      - text: Delete Pattern.any entity {entityId} from app {appId} version {versionId}.
        slots:
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove the Pattern.any model {entityId}.
        slots:
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities/{entityId}/roles/{roleId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a role on an entity
      effect: read
      questions:
      - How do I look up one role on a machine-learned entity?
      - What does LUIS return for a single simple entity role?
      instructions:
      - text: Get role {roleId} of machine-learned entity {entityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show machine-learned entity role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities/{entityId}/roles/{roleId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a role on an entity
      effect: write
      questions:
      - Can I rename a role on a machine-learned entity?
      - How do I change a simple entity role's name?
      instructions:
      - text: Rename role {roleId} of machine-learned entity {entityId} in app {appId} version {versionId} to {name}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
          name: requestBody.name
      - text: Change machine-learned entity role {roleId} to {name}.
        slots:
          roleId: path.roleId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/entities/{entityId}/roles/{roleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a role from an entity
      effect: destructive
      questions:
      - How do I delete a role from a machine-learned entity?
      - Can I remove one role from a simple entity?
      instructions:
      - text: Delete role {roleId} from machine-learned entity {entityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove machine-learned entity role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/prebuilts/{entityId}/roles/{roleId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a role on a prebuilt entity
      effect: read
      questions:
      - How do I look up one role on a prebuilt entity?
      - What does LUIS return for a single prebuilt entity role?
      instructions:
      - text: Get role {roleId} of prebuilt entity {entityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show prebuilt entity role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/prebuilts/{entityId}/roles/{roleId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a role on a prebuilt entity
      effect: write
      questions:
      - Can I rename a role on a prebuilt entity?
      - How do I change a prebuilt entity role's name?
      instructions:
      - text: Rename role {roleId} of prebuilt entity {entityId} in app {appId} version {versionId} to {name}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
          name: requestBody.name
      - text: Change prebuilt entity role {roleId} to {name}.
        slots:
          roleId: path.roleId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/prebuilts/{entityId}/roles/{roleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a role from a prebuilt entity
      effect: destructive
      questions:
      - How do I delete a role from a prebuilt entity?
      - Can I remove one role from a prebuilt entity?
      instructions:
      - text: Delete role {roleId} from prebuilt entity {entityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove prebuilt entity role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/closedlists/{entityId}/roles/{roleId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a role on a list entity
      effect: read
      questions:
      - How do I look up one role on a closed list entity?
      - What does LUIS return for a single list entity role?
      instructions:
      - text: Get role {roleId} of closed list entity {entityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show closed list role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/closedlists/{entityId}/roles/{roleId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a role on a list entity
      effect: write
      questions:
      - Can I rename a role on a closed list entity?
      - How do I change a list entity role's name?
      instructions:
      - text: Rename role {roleId} of closed list entity {entityId} in app {appId} version {versionId} to {name}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
          name: requestBody.name
      - text: Change closed list role {roleId} to {name}.
        slots:
          roleId: path.roleId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/closedlists/{entityId}/roles/{roleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a role from a list entity
      effect: destructive
      questions:
      - How do I delete a role from a closed list entity?
      - Can I remove one role from a list entity?
      instructions:
      - text: Delete role {roleId} from closed list entity {entityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove closed list role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/regexentities/{entityId}/roles/{roleId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a role on a regex entity
      effect: read
      questions:
      - How do I look up one role on a regular expression entity?
      - What does LUIS return for a single regex entity role?
      instructions:
      - text: Get role {roleId} of regex entity {entityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show regular expression entity role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/regexentities/{entityId}/roles/{roleId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a role on a regex entity
      effect: write
      questions:
      - Can I rename a role on a regular expression entity?
      - How do I change a regex entity role's name?
      instructions:
      - text: Rename role {roleId} of regex entity {entityId} in app {appId} version {versionId} to {name}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
          name: requestBody.name
      - text: Change regular expression entity role {roleId} to {name}.
        slots:
          roleId: path.roleId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/regexentities/{entityId}/roles/{roleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a role from a regex entity
      effect: destructive
      questions:
      - How do I delete a role from a regular expression entity?
      - Can I remove one role from a regex entity?
      instructions:
      - text: Delete role {roleId} from regex entity {entityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove regular expression entity role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/compositeentities/{cEntityId}/roles/{roleId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a role on a composite entity
      effect: read
      questions:
      - How do I look up one role on a composite entity?
      - Which fields come back when I fetch one role of a composite entity?
      instructions:
      - text: Get role {roleId} of composite entity {cEntityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          cEntityId: path.cEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Show composite entity role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/compositeentities/{cEntityId}/roles/{roleId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a role on a composite entity
      effect: write
      questions:
      - Can I rename a role on a composite entity?
      - How do I change a composite entity role's name?
      instructions:
      - text: Rename role {roleId} of composite entity {cEntityId} in app {appId} version {versionId} to {name}.
        slots:
          roleId: path.roleId
          cEntityId: path.cEntityId
          appId: path.appId
          versionId: path.versionId
          name: requestBody.name
      - text: Change composite entity role {roleId} to {name}.
        slots:
          roleId: path.roleId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/compositeentities/{cEntityId}/roles/{roleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a role from a composite entity
      effect: destructive
      questions:
      - How do I delete a role from a composite entity?
      - Can I remove one role from a composite entity?
      instructions:
      - text: Delete role {roleId} from composite entity {cEntityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          cEntityId: path.cEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove composite entity role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities/{entityId}/roles/{roleId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a role on a Pattern.any entity
      effect: read
      questions:
      - How do I look up one role on a Pattern.any entity?
      - What does LUIS return for a single Pattern.any role?
      instructions:
      - text: Get role {roleId} of Pattern.any entity {entityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show Pattern.any entity role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities/{entityId}/roles/{roleId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a role on a Pattern.any entity
      effect: write
      questions:
      - Can I rename a role on a Pattern.any entity?
      - How do I change a Pattern.any role's name?
      instructions:
      - text: Rename role {roleId} of Pattern.any entity {entityId} in app {appId} version {versionId} to {name}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
          name: requestBody.name
      - text: Change Pattern.any entity role {roleId} to {name}.
        slots:
          roleId: path.roleId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities/{entityId}/roles/{roleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a role from a Pattern.any entity
      effect: destructive
      questions:
      - How do I delete a role from a Pattern.any entity?
      - Can I remove one role from a Pattern.any entity?
      instructions:
      - text: Delete role {roleId} from Pattern.any entity {entityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove Pattern.any entity role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/hierarchicalentities/{hEntityId}/roles/{roleId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a role on a hierarchical entity
      effect: read
      questions:
      - How do I look up one role on a hierarchical entity?
      - What does LUIS return for a single hierarchical entity role?
      instructions:
      - text: Get role {roleId} of hierarchical entity {hEntityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          hEntityId: path.hEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Show hierarchical entity role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/hierarchicalentities/{hEntityId}/roles/{roleId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a role on a hierarchical entity
      effect: write
      questions:
      - Can I rename a role on a hierarchical entity?
      - How do I change a hierarchical entity role's name?
      instructions:
      - text: Rename role {roleId} of hierarchical entity {hEntityId} in app {appId} version {versionId} to {name}.
        slots:
          roleId: path.roleId
          hEntityId: path.hEntityId
          appId: path.appId
          versionId: path.versionId
          name: requestBody.name
      - text: Change hierarchical entity role {roleId} to {name}.
        slots:
          roleId: path.roleId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/hierarchicalentities/{hEntityId}/roles/{roleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a role from a hierarchical entity
      effect: destructive
      questions:
      - How do I delete a role from a hierarchical entity?
      - Can I remove one role from a hierarchical entity?
      instructions:
      - text: Delete role {roleId} from hierarchical entity {hEntityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          hEntityId: path.hEntityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove hierarchical entity role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/customprebuiltentities/{entityId}/roles/{roleId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a role on a prebuilt domain entity
      effect: read
      questions:
      - How do I look up one role on a customizable prebuilt domain entity?
      - What does LUIS return for a single role on a prebuilt domain entity?
      instructions:
      - text: Get role {roleId} of domain entity {entityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show custom prebuilt entity role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/customprebuiltentities/{entityId}/roles/{roleId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a role on a prebuilt domain entity
      effect: write
      questions:
      - Can I rename a role on a customizable prebuilt domain entity?
      - How do I change the name of a role on a prebuilt domain entity?
      instructions:
      - text: Rename role {roleId} of domain entity {entityId} in app {appId} version {versionId} to {name}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
          name: requestBody.name
      - text: Change custom prebuilt entity role {roleId} to {name}.
        slots:
          roleId: path.roleId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/customprebuiltentities/{entityId}/roles/{roleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a role from a prebuilt domain entity
      effect: destructive
      questions:
      - How do I delete a role from a customizable prebuilt domain entity?
      - Can I remove one role from an entity that came from a prebuilt domain?
      instructions:
      - text: Delete role {roleId} from domain entity {entityId} in app {appId} version {versionId}.
        slots:
          roleId: path.roleId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove custom prebuilt entity role {roleId}.
        slots:
          roleId: path.roleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities/{entityId}/explicitlist/{itemId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one item from a Pattern.any explicit list
      effect: read
      questions:
      - How do I look up a single item on a Pattern.any explicit list?
      - Can I read one explicit list entry by its ID?
      instructions:
      - text: Get explicit list item {itemId} of Pattern.any entity {entityId} in app {appId} version {versionId}.
        slots:
          itemId: path.itemId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Show Pattern.any explicit list entry {itemId}.
        slots:
          itemId: path.itemId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities/{entityId}/explicitlist/{itemId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update one item on a Pattern.any explicit list
      effect: write
      questions:
      - Can I change the text of one explicit list item on a Pattern.any entity?
      - How do I edit a single Pattern.any explicit list entry?
      instructions:
      - text: Change explicit list item {itemId} of Pattern.any entity {entityId} in app {appId} version {versionId} to {explicitListItem}.
        slots:
          itemId: path.itemId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
          explicitListItem: requestBody.explicitListItem
      - text: Update Pattern.any explicit list entry {itemId} to {explicitListItem}.
        slots:
          itemId: path.itemId
          explicitListItem: requestBody.explicitListItem
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternanyentities/{entityId}/explicitlist/{itemId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one item from a Pattern.any explicit list
      effect: destructive
      questions:
      - How do I remove a single item from a Pattern.any explicit list?
      - Can I delete one explicit list entry without touching the rest?
      instructions:
      - text: Delete explicit list item {itemId} from Pattern.any entity {entityId} in app {appId} version {versionId}.
        slots:
          itemId: path.itemId
          entityId: path.entityId
          appId: path.appId
          versionId: path.versionId
      - text: Remove Pattern.any explicit list entry {itemId}.
        slots:
          itemId: path.itemId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternrule'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a pattern to a LUIS version
      effect: write
      questions:
      - How do I add a single template utterance pattern for an intent?
      - Can I create a template utterance with an entity placeholder for one intent?
      instructions:
      - text: Add pattern {pattern} for intent {intent} to app {appId} version {versionId}.
        slots:
          pattern: requestBody.pattern
          intent: requestBody.intent
          appId: path.appId
          versionId: path.versionId
      - text: Create one pattern rule {pattern} mapped to intent {intent}.
        slots:
          pattern: requestBody.pattern
          intent: requestBody.intent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternrules'].get
  update:
    x-apievangelist-phrasing:
      intent: List patterns in a LUIS version
      effect: read
      questions:
      - Which patterns are defined across my whole LUIS version?
      - Can I page through every pattern rule in a version?
      instructions:
      - text: List the patterns in app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Show {take} pattern rules of LUIS version {versionId}.
        slots:
          take: query.take
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternrules'].put
  update:
    x-apievangelist-phrasing:
      intent: Update several patterns at once
      effect: write
      questions:
      - Can I edit many patterns in a single request?
      - How do I bulk-update existing pattern rules in a LUIS version?
      instructions:
      - text: Update this batch of existing patterns in app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Bulk-edit pattern rules in LUIS version {versionId} of {appId}.
        slots:
          versionId: path.versionId
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternrules'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a batch of patterns
      effect: write
      questions:
      - Is there a way to add many new patterns to a LUIS version in one call?
      - How do I bulk-create pattern rules?
      instructions:
      - text: Add this batch of new patterns to app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Bulk-create pattern rules in LUIS version {versionId} of {appId}.
        slots:
          versionId: path.versionId
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternrules'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete several patterns at once
      effect: destructive
      questions:
      - Can I delete multiple patterns in a single request?
      - How do I bulk-remove pattern rules from a LUIS version?
      instructions:
      - text: Delete these patterns from app {appId} version {versionId}.
        slots:
          appId: path.appId
          versionId: path.versionId
      - text: Bulk-remove the listed pattern rules from LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternrules/{patternId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update one pattern
      effect: write
      questions:
      - Can I change the text or intent of a single existing pattern?
      - How do I edit one pattern rule by its ID?
      instructions:
      - text: Update pattern {patternId} in app {appId} version {versionId} to {pattern}.
        slots:
          patternId: path.patternId
          appId: path.appId
          versionId: path.versionId
          pattern: requestBody.pattern
      - text: Move pattern {patternId} to intent {intent}.
        slots:
          patternId: path.patternId
          intent: requestBody.intent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/patternrules/{patternId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one pattern
      effect: destructive
      questions:
      - How do I remove a single pattern rule by its ID?
      - Can I delete just one pattern and keep the others?
      instructions:
      - text: Delete pattern {patternId} from app {appId} version {versionId}.
        slots:
          patternId: path.patternId
          appId: path.appId
          versionId: path.versionId
      - text: Remove pattern rule {patternId}.
        slots:
          patternId: path.patternId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/intents/{intentId}/patternrules'].get
  update:
    x-apievangelist-phrasing:
      intent: List patterns for one intent
      effect: read
      questions:
      - Which patterns belong to a specific intent?
      - How do I see only the pattern rules attached to one intent?
      instructions:
      - text: List patterns for intent {intentId} in app {appId} version {versionId}.
        slots:
          intentId: path.intentId
          appId: path.appId
          versionId: path.versionId
      - text: Show pattern rules of LUIS intent {intentId}.
        slots:
          intentId: path.intentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the settings of a LUIS app version
      effect: read
      questions:
      - Which normalization settings are applied to one version of my LUIS app?
      - Is punctuation or diacritics normalization turned on for a LUIS version?
      instructions:
      - text: Get the settings of version {versionId} of LUIS app {appId}.
        slots:
          versionId: path.versionId
          appId: path.appId
      - text: Show whether LUIS app {appId} version {versionId} normalizes punctuation.
        slots:
          appId: path.appId
          versionId: path.versionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/apps/{appId}/versions/{versionId}/settings'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a LUIS version's settings
      effect: write
      questions:
      - Can I change settings such as punctuation normalization on a LUIS version?
      - How do I update the settings of a single LUIS app version?
      instructions:
      - text: Update the settings of version {versionId} of LUIS app {appId}.
        slots:
          versionId: path.versionId
          appId: path.appId
      - text: Change version settings for LUIS version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/azureaccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure accounts assigned to a LUIS app
      effect: read
      questions:
      - Which Azure prediction resources are assigned to my LUIS app?
      - How do I see the Azure accounts linked to a LUIS application?
      instructions:
      - text: List the Azure accounts assigned to LUIS app {appId}.
        slots:
          appId: path.appId
      - text: Show the Azure resources linked to app {appId}.
        slots:
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/azureaccounts'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign an Azure account to a LUIS app
      effect: write
      questions:
      - How do I link an Azure LUIS resource to my application?
      - What do I need to assign a prediction resource to a LUIS app?
      instructions:
      - text: Assign Azure account {accountName} in resource group {resourceGroup} to LUIS app {appId}.
        slots:
          accountName: requestBody.accountName
          resourceGroup: requestBody.resourceGroup
          appId: path.appId
      - text: Link account {accountName} from subscription {azureSubscriptionId} to app {appId}.
        slots:
          accountName: requestBody.accountName
          azureSubscriptionId: requestBody.azureSubscriptionId
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/azureaccounts'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unassign an Azure account from a LUIS app
      effect: destructive
      questions:
      - How do I unlink an Azure resource from my LUIS app?
      - Can I remove a prediction resource that is assigned to an application?
      instructions:
      - text: Remove Azure account {accountName} in resource group {resourceGroup} from LUIS app {appId}.
        slots:
          accountName: requestBody.accountName
          resourceGroup: requestBody.resourceGroup
          appId: path.appId
      - text: Unassign account {accountName} of subscription {azureSubscriptionId} from app {appId}.
        slots:
          accountName: requestBody.accountName
          azureSubscriptionId: requestBody.azureSubscriptionId
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/predict'].get
  update:
    x-apievangelist-phrasing:
      intent: Predict intent for a query against a version (GET)
      effect: read
      questions:
      - Can I test a query against an unpublished LUIS version with a simple GET?
      - How do I see all intent scores for an utterance on one version?
      instructions:
      - text: Predict the intent of {query} using version {versionId} of app {appId}.
        slots:
          query: query.query
          versionId: path.versionId
          appId: path.appId
      - text: Score {query} on LUIS version {versionId} with show-all-intents {show-all-intents}.
        slots:
          query: query.query
          versionId: path.versionId
          show-all-intents: query.show-all-intents
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/versions/{versionId}/predict'].post
  update:
    x-apievangelist-phrasing:
      intent: Predict against a version with options (POST)
      effect: read
      questions:
      - Can I pass external entities or dynamic lists when predicting against a version?
      - How do I send a prediction request body to a specific LUIS version?
      instructions:
      - text: Post query {query} for prediction to version {versionId} of app {appId} with external entities {externalEntities}.
        slots:
          query: requestBody.query
          versionId: path.versionId
          appId: path.appId
          externalEntities: requestBody.externalEntities
      - text: Predict {query} on version {versionId} using dynamic lists {dynamicLists}.
        slots:
          query: requestBody.query
          versionId: path.versionId
          dynamicLists: requestBody.dynamicLists
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/slots/{slotName}/predict'].get
  update:
    x-apievangelist-phrasing:
      intent: Predict intent for a query against a slot (GET)
      effect: read
      questions:
      - How do I get a prediction from my published production or staging slot?
      - Can I query a published LUIS slot with a simple GET?
      instructions:
      - text: Predict the intent of {query} on slot {slotName} of app {appId}.
        slots:
          query: query.query
          slotName: path.slotName
          appId: path.appId
      - text: Score {query} against the {slotName} slot with verbose {verbose}.
        slots:
          query: query.query
          slotName: path.slotName
          verbose: query.verbose
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps/{appId}/slots/{slotName}/predict'].post
  update:
    x-apievangelist-phrasing:
      intent: Predict against a slot with options (POST)
      effect: read
      questions:
      - Can I pass external entities when predicting against a published slot?
      - How do I send a prediction request body to the production slot?
      instructions:
      - text: Post query {query} for prediction to slot {slotName} of app {appId} with external entities {externalEntities}.
        slots:
          query: requestBody.query
          slotName: path.slotName
          appId: path.appId
          externalEntities: requestBody.externalEntities
      - text: Predict {query} on published slot {slotName} using dynamic lists {dynamicLists}.
        slots:
          query: requestBody.query
          slotName: path.slotName
          dynamicLists: requestBody.dynamicLists
      method: generated
      generated: '2026-09-26'