# 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 Workflow Versions API
  version: 1.0.0
extends: openapi/microsoft-azure-workflow-versions-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List versions of a Consumption Logic App workflow
      effect: read
      questions:
      - What past versions exist for my Consumption Logic Apps workflow?
      - Can I limit how many workflow versions come back for a Logic App?
      instructions:
      - text: List the versions of Logic Apps workflow {workflowName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the latest {top} versions of Consumption workflow {workflowName}.
        slots:
          top: query.$top
          workflowName: path.workflowName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/versions/{versionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a version of a Consumption Logic App workflow
      effect: read
      questions:
      - What did a Consumption Logic Apps workflow definition look like in an earlier version?
      - Can I retrieve one specific version of a Logic App by version id?
      instructions:
      - text: Show version {versionId} of Logic Apps workflow {workflowName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          versionId: path.versionId
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Get Consumption workflow {workflowName} as it was at version {versionId}.
        slots:
          workflowName: path.workflowName
          versionId: path.versionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hostruntime/runtime/webhooks/workflow/api/management/workflows/{workflowName}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List versions of a Standard workflow in a web app
      effect: read
      questions:
      - What versions exist for a Standard Logic Apps workflow hosted in my app site?
      - Can I list workflow versions through a site's host runtime?
      instructions:
      - text: List the versions of workflow {workflowName} in site {name}, resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          workflowName: path.workflowName
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the latest {top} versions of Standard workflow {workflowName} hosted in app {name}.
        slots:
          top: query.$top
          workflowName: path.workflowName
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hostruntime/runtime/webhooks/workflow/api/management/workflows/{workflowName}/versions/{versionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a version of a Standard workflow in a web app
      effect: read
      questions:
      - How do I pull an older version of a Standard Logic Apps workflow running in my app site?
      - Can I fetch one workflow version via the site's host runtime?
      instructions:
      - text: Show version {versionId} of workflow {workflowName} in site {name}, resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          versionId: path.versionId
          workflowName: path.workflowName
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Get Standard workflow {workflowName} in app {name} as it was at version {versionId}.
        slots:
          workflowName: path.workflowName
          name: path.name
          versionId: path.versionId
      method: generated
      generated: '2026-10-01'