# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for WebApps API Client Workflow Versions API
  version: 1.0.0
extends: openapi/microsoft-azure-functions-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: 2
- 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 workflow
      effect: read
      questions:
      - What versions of my workflow have been saved?
      - Can I limit the workflow version history to the most recent few?
      instructions:
      - text: List the versions of workflow {workflowName} on app {name}.
        slots:
          workflowName: path.workflowName
          name: path.name
      - text: Show the latest {top} versions of workflow {workflowName} in site {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 specific workflow version
      effect: read
      questions:
      - What did a particular earlier version of my workflow look like?
      - Can I retrieve one workflow version by its version ID?
      instructions:
      - text: Get version {versionId} of workflow {workflowName} on app {name}.
        slots:
          versionId: path.versionId
          workflowName: path.workflowName
          name: path.name
      - text: Show the definition saved as version {versionId} for workflow {workflowName} in site {name}.
        slots:
          versionId: path.versionId
          workflowName: path.workflowName
          name: path.name
      method: generated
      generated: '2026-10-01'