# 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 Gateways API
  version: 1.0.0
extends: openapi/microsoft-azure-meshgateways-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: 4
- target: $.paths['/Resources/Gateways/{gatewayResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Service Fabric Mesh gateway
      effect: read
      questions:
      - What is the description and configuration of one of my mesh gateways?
      - Can I look up a gateway resource by its name?
      instructions:
      - text: Get gateway {gateway}.
        slots:
          gateway: path.gatewayResourceName
      - text: Show the properties of mesh gateway {gateway}.
        slots:
          gateway: path.gatewayResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Resources/Gateways/{gatewayResourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a mesh gateway
      effect: write
      questions:
      - How do I create a gateway resource that routes traffic into my mesh network?
      - Will creating a gateway with an existing name update it instead?
      instructions:
      - text: Create gateway {gateway} from description {description}.
        slots:
          gateway: path.gatewayResourceName
          description: body.gatewayResourceDescription
      - text: Replace the definition of mesh gateway {gateway} with {description}.
        slots:
          gateway: path.gatewayResourceName
          description: body.gatewayResourceDescription
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Resources/Gateways/{gatewayResourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a mesh gateway
      effect: destructive
      questions:
      - How do I delete a gateway resource from my mesh?
      - Can I remove a mesh gateway by name?
      instructions:
      - text: Delete gateway {gateway}.
        slots:
          gateway: path.gatewayResourceName
      - text: Tear down mesh gateway {gateway}.
        slots:
          gateway: path.gatewayResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Resources/Gateways'].get
  update:
    x-apievangelist-phrasing:
      intent: List all mesh gateways
      effect: read
      questions:
      - Which gateway resources exist in my mesh?
      - Can I see all gateways along with their descriptions?
      instructions:
      - text: List every gateway resource.
      - text: Show all mesh gateways using API version {api_version}.
        slots:
          api_version: query.api-version
      method: generated
      generated: '2026-09-26'