# 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 Applications API
  version: 1.0.0
extends: openapi/microsoft-azure-applications-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 35
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/applications/{applicationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a managed application by name
      effect: read
      questions:
      - What details can I see for a managed application in my resource group?
      - Can I look up a Microsoft.Solutions managed application just by its name?
      instructions:
      - text: Show me the managed application named {applicationName}.
        slots:
          applicationName: path.applicationName
      - text: Get the plan and managedBy details of managed application {applicationName}.
        slots:
          applicationName: path.applicationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/applications/{applicationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a managed application by name
      effect: write
      questions:
      - How do I deploy a new managed application into a resource group by name?
      - Which fields are required when creating a managed application, like kind and properties?
      instructions:
      - text: Create a managed application named {applicationName} of kind {kind}.
        slots:
          applicationName: path.applicationName
          kind: requestBody.kind
      - text: Create or replace the managed application {applicationName} in my resource group.
        slots:
          applicationName: path.applicationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/applications/{applicationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a managed application by name
      effect: destructive
      questions:
      - Can I remove a managed application from a resource group using its name?
      - What happens to a managed application when I delete it by name?
      instructions:
      - text: Delete the managed application named {applicationName}.
        slots:
          applicationName: path.applicationName
      - text: Remove managed application {applicationName} from this resource group.
        slots:
          applicationName: path.applicationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/applications/{applicationName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a managed application by name
      effect: write
      questions:
      - Can I change the SKU or identity of an existing managed application by name?
      - Is it possible to patch only the plan of a managed application I address by name?
      instructions:
      - text: Update the SKU of managed application {applicationName} to {sku}.
        slots:
          applicationName: path.applicationName
          sku: requestBody.sku
      - text: Patch the managed application {applicationName} with a new managedBy value {managedBy}.
        slots:
          applicationName: path.applicationName
          managedBy: requestBody.managedBy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/applications'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed applications in a resource group
      effect: read
      questions:
      - Which managed applications are deployed in this resource group?
      - Can I see every Microsoft.Solutions managed application in one resource group?
      instructions:
      - text: List the managed applications in my resource group.
      - text: Show all managed applications deployed to this resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Solutions/applications'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed applications in a subscription
      effect: read
      questions:
      - What managed applications exist across my whole Azure subscription?
      - Is there a subscription-wide inventory of managed applications?
      instructions:
      - text: List every managed application in my subscription.
      - text: Give me a subscription-wide list of managed applications.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{applicationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a managed application by resource ID
      effect: read
      questions:
      - Can I fetch a managed application using its full resource ID instead of its name?
      - What does the managed application at a given resource ID look like?
      instructions:
      - text: Get the managed application with resource ID {applicationId}.
        slots:
          applicationId: path.applicationId
      - text: Look up managed application {applicationId} by its full ID.
        slots:
          applicationId: path.applicationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{applicationId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a managed application by ID
      effect: write
      questions:
      - Can I create a managed application by addressing its full resource ID?
      - Which body fields does creating a managed application by resource ID require?
      instructions:
      - text: Create or update the managed application at resource ID {applicationId} with kind {kind}.
        slots:
          applicationId: path.applicationId
          kind: requestBody.kind
      - text: Deploy a managed application to resource ID {applicationId}.
        slots:
          applicationId: path.applicationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{applicationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a managed application by resource ID
      effect: destructive
      questions:
      - Can I delete a managed application when I only have its resource ID?
      - Is deleting a managed application by full ID permanent?
      instructions:
      - text: Delete the managed application with resource ID {applicationId}.
        slots:
          applicationId: path.applicationId
      - text: Remove managed application {applicationId} using its full ID.
        slots:
          applicationId: path.applicationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{applicationId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a managed application by resource ID
      effect: write
      questions:
      - Can I patch a managed application by its resource ID rather than its name?
      - Is it possible to change a managed application's plan by referencing its full ID?
      instructions:
      - text: Update the plan of managed application {applicationId} to {plan}.
        slots:
          applicationId: path.applicationId
          plan: requestBody.plan
      - text: Patch the managed application at resource ID {applicationId} with SKU {sku}.
        slots:
          applicationId: path.applicationId
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/applications/{applicationName}/refreshPermissions'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh permissions for a managed application
      effect: write
      questions:
      - Can I re-sync the permissions granted to a managed application?
      - What should I call when a managed application's permissions look out of date?
      instructions:
      - text: Refresh permissions for managed application {applicationName}.
        slots:
          applicationName: path.applicationName
      - text: Re-apply the permissions on managed application {applicationName}.
        slots:
          applicationName: path.applicationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/applications/{applicationName}/listAllowedUpgradePlans'].post
  update:
    x-apievangelist-phrasing:
      intent: List allowed upgrade plans for a managed app
      effect: read
      questions:
      - Which plans can my managed application be upgraded to?
      - Are there any upgrade plans available for this managed application?
      instructions:
      - text: List the allowed upgrade plans for managed application {applicationName}.
        slots:
          applicationName: path.applicationName
      - text: Show which plans {applicationName} can upgrade to.
        slots:
          applicationName: path.applicationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/applications/{applicationName}/updateAccess'].post
  update:
    x-apievangelist-phrasing:
      intent: Update just-in-time access for a managed app
      effect: write
      questions:
      - How can I approve or change access to a managed application?
      - Can I set an access status and sub-status on a managed application request?
      instructions:
      - text: Set access status {status} with sub-status {subStatus} on managed application {applicationName}.
        slots:
          status: requestBody.status
          subStatus: requestBody.subStatus
          applicationName: path.applicationName
      - text: Update access for managed application {applicationName} as approver {approver}.
        slots:
          applicationName: path.applicationName
          approver: requestBody.approver
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/applications/{applicationName}/listTokens'].post
  update:
    x-apievangelist-phrasing:
      intent: List access tokens for a managed application
      effect: read
      questions:
      - Can I get tokens for a managed application's user-assigned identities?
      - Which tokens does a managed application issue for a given authorization audience?
      instructions:
      - text: List tokens for managed application {applicationName}.
        slots:
          applicationName: path.applicationName
      - text: Get tokens for {applicationName} scoped to audience {authorizationAudience}.
        slots:
          applicationName: path.applicationName
          authorizationAudience: requestBody.authorizationAudience
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applications'].get
  update:
    x-apievangelist-phrasing:
      intent: List Batch applications usable on compute nodes
      effect: read
      questions:
      - Which Batch applications and versions can my compute nodes use?
      - Can I cap how many Batch applications come back in one page?
      instructions:
      - text: List the Batch applications available in my Batch account.
      - text: Show up to {maxresults} Batch applications usable in package references.
        slots:
          maxresults: query.maxresults
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applications/{applicationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Batch application's details
      effect: read
      questions:
      - What versions of a specific Batch application are available to compute nodes?
      - Can I check whether a Batch application package is usable in a package reference?
      instructions:
      - text: Get the Batch application {applicationId}.
        slots:
          applicationId: path.applicationId
      - text: Show the available versions of Batch application {applicationId}.
        slots:
          applicationId: path.applicationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IntegrationSpaces/spaces/{spaceName}/applications'].get
  update:
    x-apievangelist-phrasing:
      intent: List applications in an Integration Space
      effect: read
      questions:
      - Which applications live in my Azure Integration Space?
      - Can I filter or page through the applications in an integration space?
      instructions:
      - text: List the applications in integration space {spaceName}.
        slots:
          spaceName: path.spaceName
      - text: Show the first {top} applications in space {spaceName}.
        slots:
          top: query.top
          spaceName: path.spaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IntegrationSpaces/spaces/{spaceName}/applications/{applicationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an application in an Integration Space
      effect: read
      questions:
      - What does a single application inside an integration space contain?
      - Can I look up one integration space application by name?
      instructions:
      - text: Get application {applicationName} in integration space {spaceName}.
        slots:
          applicationName: path.applicationName
          spaceName: path.spaceName
      - text: Show the details of space {spaceName}'s application {applicationName}.
        slots:
          spaceName: path.spaceName
          applicationName: path.applicationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IntegrationSpaces/spaces/{spaceName}/applications/{applicationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an application in an Integration Space
      effect: write
      questions:
      - How do I add a new application to an integration space?
      - Can I create an integration space application with custom properties?
      instructions:
      - text: Create application {applicationName} in integration space {spaceName}.
        slots:
          applicationName: path.applicationName
          spaceName: path.spaceName
      - text: Add a new application called {applicationName} to space {spaceName}.
        slots:
          applicationName: path.applicationName
          spaceName: path.spaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IntegrationSpaces/spaces/{spaceName}/applications/{applicationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an application from an Integration Space
      effect: destructive
      questions:
      - Can I remove an application from my integration space?
      - What happens when I delete an integration space application?
      instructions:
      - text: Delete application {applicationName} from integration space {spaceName}.
        slots:
          applicationName: path.applicationName
          spaceName: path.spaceName
      - text: Remove the {applicationName} application in space {spaceName}.
        slots:
          applicationName: path.applicationName
          spaceName: path.spaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IntegrationSpaces/spaces/{spaceName}/applications/{applicationName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an application in an Integration Space
      effect: write
      questions:
      - Can I change the tags on an integration space application?
      - Is it possible to patch an existing application's properties inside a space?
      instructions:
      - text: Update the tags on application {applicationName} in integration space {spaceName}.
        slots:
          applicationName: path.applicationName
          spaceName: path.spaceName
      - text: Patch integration space {spaceName} application {applicationName} with new properties.
        slots:
          spaceName: path.spaceName
          applicationName: path.applicationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IntegrationSpaces/spaces/{spaceName}/applications/{applicationName}/deleteBusinessProcessDevelopmentArtifact'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a business process development artifact
      effect: destructive
      questions:
      - Can I delete a business process development artifact from an integration space application?
      - Is there a way to discard a saved business process draft by name?
      instructions:
      - text: Delete business process artifact {name} from application {applicationName} in space {spaceName}.
        slots:
          name: requestBody.name
          applicationName: path.applicationName
          spaceName: path.spaceName
      - text: Discard the business process development artifact {name} in {applicationName}.
        slots:
          name: requestBody.name
          applicationName: path.applicationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IntegrationSpaces/spaces/{spaceName}/applications/{applicationName}/getBusinessProcessDevelopmentArtifact'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a business process development artifact
      effect: read
      questions:
      - Can I open one business process development artifact by name?
      - What does a saved business process draft in my integration application contain?
      instructions:
      - text: Get business process artifact {name} from application {applicationName} in space {spaceName}.
        slots:
          name: requestBody.name
          applicationName: path.applicationName
          spaceName: path.spaceName
      - text: Show the content of business process development artifact {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IntegrationSpaces/spaces/{spaceName}/applications/{applicationName}/listBusinessProcessDevelopmentArtifacts'].post
  update:
    x-apievangelist-phrasing:
      intent: List business process development artifacts
      effect: read
      questions:
      - Which business process development artifacts exist in an integration space application?
      - Can I see all the business process drafts saved for one application?
      instructions:
      - text: List business process development artifacts for application {applicationName} in space {spaceName}.
        slots:
          applicationName: path.applicationName
          spaceName: path.spaceName
      - text: Show every business process draft in {applicationName}.
        slots:
          applicationName: path.applicationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IntegrationSpaces/spaces/{spaceName}/applications/{applicationName}/saveBusinessProcessDevelopmentArtifact'].post
  update:
    x-apievangelist-phrasing:
      intent: Save a business process development artifact
      effect: write
      questions:
      - How do I save a business process development artifact to an integration application?
      - Can I overwrite a business process draft by saving it under the same name?
      instructions:
      - text: Save business process artifact {name} to application {applicationName} in space {spaceName}.
        slots:
          name: requestBody.name
          applicationName: path.applicationName
          spaceName: path.spaceName
      - text: Store my business process draft as {name} in {applicationName}.
        slots:
          name: requestBody.name
          applicationName: path.applicationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IntegrationSpaces/spaces/{spaceName}/applications/{applicationName}/validateBusinessProcessDevelopmentArtifact'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a business process development artifact
      effect: read
      questions:
      - Can I check a business process development artifact for errors before saving it?
      - Is my business process draft valid for this integration application?
      instructions:
      - text: Validate business process artifact {name} for application {applicationName} in space {spaceName}.
        slots:
          name: requestBody.name
          applicationName: path.applicationName
          spaceName: path.spaceName
      - text: Check whether business process draft {name} is valid.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabricMesh/applications/{applicationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Service Fabric Mesh application
      effect: read
      questions:
      - What services and runtime properties does my Service Fabric Mesh application have?
      - Can I inspect one Mesh application resource by name?
      instructions:
      - text: Get Service Fabric Mesh application {applicationName} in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          applicationName: path.applicationName
          resourceGroupName: path.resourceGroupName
      - text: Show the runtime status of Mesh application {applicationName}.
        slots:
          applicationName: path.applicationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabricMesh/applications/{applicationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Service Fabric Mesh application
      effect: write
      questions:
      - How do I deploy a Service Fabric Mesh application resource?
      - If a Mesh application with the same name exists, does creating it again update its description?
      instructions:
      - text: Create Service Fabric Mesh application {applicationName} in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          applicationName: path.applicationName
          resourceGroupName: path.resourceGroupName
      - text: Update the description of Mesh application {applicationName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          applicationName: path.applicationName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabricMesh/applications/{applicationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Service Fabric Mesh application
      effect: destructive
      questions:
      - Can I tear down a Service Fabric Mesh application by name?
      - What is removed when I delete a Mesh application resource?
      instructions:
      - text: Delete Service Fabric Mesh application {applicationName} in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          applicationName: path.applicationName
          resourceGroupName: path.resourceGroupName
      - text: Remove the Mesh application {applicationName} from {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          applicationName: path.applicationName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabricMesh/applications'].get
  update:
    x-apievangelist-phrasing:
      intent: List Service Fabric Mesh apps in a resource group
      effect: read
      questions:
      - Which Service Fabric Mesh applications are in a given resource group?
      - Can I see the runtime properties of every Mesh app in one resource group?
      instructions:
      - text: List the Service Fabric Mesh applications in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
      - text: Show all Mesh application resources under {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ServiceFabricMesh/applications'].get
  update:
    x-apievangelist-phrasing:
      intent: List Service Fabric Mesh apps in a subscription
      effect: read
      questions:
      - What Service Fabric Mesh applications are running across my subscription?
      - Is there a subscription-level listing of Mesh application resources?
      instructions:
      - text: List all Service Fabric Mesh applications in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every Mesh application resource across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Applications/{applicationId}/$/GetServices'].get
  update:
    x-apievangelist-phrasing:
      intent: List services in a Service Fabric application
      effect: read
      questions:
      - Which services belong to a Service Fabric application?
      - Can I filter a Service Fabric application's services by service type name?
      instructions:
      - text: List the services in Service Fabric application {applicationId}.
        slots:
          applicationId: path.applicationId
      - text: Show services of type {ServiceTypeName} in application {applicationId}.
        slots:
          ServiceTypeName: query.ServiceTypeName
          applicationId: path.applicationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Applications/{applicationId}/$/GetServices/{serviceId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one service in a Service Fabric application
      effect: read
      questions:
      - What is the status of a specific service inside my Service Fabric application?
      - Can I fetch a single Service Fabric service by its service ID?
      instructions:
      - text: Get service {serviceId} in Service Fabric application {applicationId}.
        slots:
          serviceId: path.serviceId
          applicationId: path.applicationId
      - text: Show details for Service Fabric service {serviceId}.
        slots:
          serviceId: path.serviceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Applications/{applicationId}/$/GetServices/$/Create'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a stateless or stateful Service Fabric service
      effect: write
      questions:
      - How do I create a stateful or stateless service under a Service Fabric application?
      - Can I set partitioning details when I create a Service Fabric service?
      instructions:
      - text: Create a new Service Fabric service under application {applicationId}.
        slots:
          applicationId: path.applicationId
      - text: Add a partitioned stateful service to Service Fabric application {applicationId}.
        slots:
          applicationId: path.applicationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Applications/{applicationId}/$/GetServices/$/CreateFromTemplate'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Service Fabric service from a template
      effect: write
      questions:
      - Can I create a Service Fabric service from a template in the application manifest?
      - What is a service template and how does it help create services?
      instructions:
      - text: Create a service from the manifest template in Service Fabric application {applicationId}.
        slots:
          applicationId: path.applicationId
      - text: Instantiate a templated service for application {applicationId}.
        slots:
          applicationId: path.applicationId
      method: generated
      generated: '2026-09-26'