# 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 Service Fabric Client Mesh Applications API
  version: 1.0.0
extends: openapi/microsoft-azure-meshapplications-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: 5
- target: $.paths['/Resources/Applications/{applicationResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Mesh application
      effect: read
      questions:
      - How do I see the description and properties of one Service Fabric Mesh application?
      - Can I look up a Mesh application by its name?
      instructions:
      - text: Get Mesh application {applicationResourceName}.
        slots:
          applicationResourceName: path.applicationResourceName
      - text: Show the properties of Service Fabric Mesh application {applicationResourceName}.
        slots:
          applicationResourceName: path.applicationResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Resources/Applications/{applicationResourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Mesh application
      effect: write
      questions:
      - How do I deploy a new application resource to Service Fabric Mesh?
      - What happens if I create a Mesh application with a name that already exists?
      instructions:
      - text: Create Mesh application {applicationResourceName} from {applicationResourceDescription}.
        slots:
          applicationResourceName: path.applicationResourceName
          applicationResourceDescription: body.applicationResourceDescription
      - text: Update Mesh application {applicationResourceName} with the description {applicationResourceDescription}.
        slots:
          applicationResourceName: path.applicationResourceName
          applicationResourceDescription: body.applicationResourceDescription
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Resources/Applications/{applicationResourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Mesh application
      effect: destructive
      questions:
      - How do I remove an application from Service Fabric Mesh?
      - Can I delete a Mesh application resource by name?
      instructions:
      - text: Delete Mesh application {applicationResourceName}.
        slots:
          applicationResourceName: path.applicationResourceName
      - text: Tear down the Service Fabric Mesh application {applicationResourceName}.
        slots:
          applicationResourceName: path.applicationResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Resources/Applications'].get
  update:
    x-apievangelist-phrasing:
      intent: List Mesh applications
      effect: read
      questions:
      - Which applications are running in my Service Fabric Mesh environment?
      - Is there a way to list every Mesh application resource?
      instructions:
      - text: List all Service Fabric Mesh applications using API version {api-version}.
        slots:
          api-version: query.api-version
      - text: Show every Mesh application resource with its description.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Resources/Applications/{applicationResourceName}/$/GetUpgradeProgress'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Mesh application's upgrade progress
      effect: read
      questions:
      - How far along is the latest upgrade of my Mesh application?
      - Can I check the completion percentage of an application upgrade?
      instructions:
      - text: Get the upgrade progress of Mesh application {applicationResourceName}.
        slots:
          applicationResourceName: path.applicationResourceName
      - text: Show how far the latest upgrade of {applicationResourceName} has gotten.
        slots:
          applicationResourceName: path.applicationResourceName
      method: generated
      generated: '2026-09-26'