# 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 Run Actions API
  version: 1.0.0
extends: openapi/microsoft-azure-functions-workflowrunactions-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hostruntime/runtime/webhooks/workflow/api/management/workflows/{workflowName}/runs/{runName}/actions'].get
  update:
    x-apievangelist-phrasing:
      intent: List the actions of a workflow run
      effect: read
      questions:
      - Which actions executed in a particular Logic Apps workflow run?
      - Can I filter a run's actions to only the ones that failed?
      instructions:
      - text: List the actions in run {runName} of workflow {workflowName} on app {name}.
        slots:
          runName: path.runName
          workflowName: path.workflowName
          name: path.name
      - text: Show the first {top} actions of run {runName} matching {filter}.
        slots:
          top: query.$top
          runName: path.runName
          filter: query.$filter
      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}/runs/{runName}/actions/{actionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one action from a workflow run
      effect: read
      questions:
      - How do I see the status and outputs of one action in a workflow run?
      - What happened to a specific step during a run?
      instructions:
      - text: Get action {actionName} from run {runName} of workflow {workflowName} on app {name}.
        slots:
          actionName: path.actionName
          runName: path.runName
          workflowName: path.workflowName
          name: path.name
      - text: Show the result of step {actionName} in run {runName}.
        slots:
          actionName: path.actionName
          runName: path.runName
      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}/runs/{runName}/actions/{actionName}/listExpressionTraces'].post
  update:
    x-apievangelist-phrasing:
      intent: List expression traces for a run action
      effect: read
      questions:
      - How can I see how expressions were evaluated in a workflow action?
      - Why did an action's expression produce an unexpected value?
      instructions:
      - text: List expression traces for action {actionName} in run {runName} of workflow {workflowName} on app {name}.
        slots:
          actionName: path.actionName
          runName: path.runName
          workflowName: path.workflowName
          name: path.name
      - text: Trace how expressions evaluated in action {actionName}.
        slots:
          actionName: path.actionName
      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}/runs/{runName}/actions/{actionName}/repetitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List repetitions of a looping workflow action
      effect: read
      questions:
      - How do I see every iteration of a for-each action in a workflow run?
      - Which loop repetitions ran for an action?
      instructions:
      - text: List repetitions of action {actionName} in run {runName} of workflow {workflowName} on app {name}.
        slots:
          actionName: path.actionName
          runName: path.runName
          workflowName: path.workflowName
          name: path.name
      - text: Show each loop iteration of action {actionName}.
        slots:
          actionName: path.actionName
      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}/runs/{runName}/actions/{actionName}/repetitions/{repetitionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one repetition of a workflow action
      effect: read
      questions:
      - What happened in one specific iteration of a looping action?
      - How do I inspect a single repetition's inputs and outputs?
      instructions:
      - text: Get repetition {repetitionName} of action {actionName} in run {runName} of workflow {workflowName} on app {name}.
        slots:
          repetitionName: path.repetitionName
          actionName: path.actionName
          runName: path.runName
          workflowName: path.workflowName
          name: path.name
      - text: Show loop iteration {repetitionName} of action {actionName}.
        slots:
          repetitionName: path.repetitionName
          actionName: path.actionName
      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}/runs/{runName}/actions/{actionName}/repetitions/{repetitionName}/listExpressionTraces'].post
  update:
    x-apievangelist-phrasing:
      intent: List expression traces for an action repetition
      effect: read
      questions:
      - Can I see expression evaluation for one loop iteration rather than the whole action?
      - Why did an expression misbehave in a single repetition?
      instructions:
      - text: List expression traces for repetition {repetitionName} of action {actionName} in run {runName} of workflow {workflowName} on {name}.
        slots:
          repetitionName: path.repetitionName
          actionName: path.actionName
          runName: path.runName
          workflowName: path.workflowName
          name: path.name
      - text: Trace expressions within iteration {repetitionName}.
        slots:
          repetitionName: path.repetitionName
      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}/runs/{runName}/actions/{actionName}/repetitions/{repetitionName}/requestHistories'].get
  update:
    x-apievangelist-phrasing:
      intent: List request histories for an action repetition
      effect: read
      questions:
      - What HTTP requests did one loop iteration of an action send?
      - How do I review the request history for a repetition?
      instructions:
      - text: List request histories for repetition {repetitionName} of action {actionName} in run {runName} of workflow {workflowName} on {name}.
        slots:
          repetitionName: path.repetitionName
          actionName: path.actionName
          runName: path.runName
          workflowName: path.workflowName
          name: path.name
      - text: Show outbound request history for iteration {repetitionName}.
        slots:
          repetitionName: path.repetitionName
      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}/runs/{runName}/actions/{actionName}/repetitions/{repetitionName}/requestHistories/{requestHistoryName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one request history for an action repetition
      effect: read
      questions:
      - How do I see the exact request and response for one call made during a repetition?
      - What did a single recorded request in a loop iteration return?
      instructions:
      - text: Get request history {requestHistoryName} for repetition {repetitionName} of action {actionName} in run {runName} of {workflowName} on {name}.
        slots:
          requestHistoryName: path.requestHistoryName
          repetitionName: path.repetitionName
          actionName: path.actionName
          runName: path.runName
          workflowName: path.workflowName
          name: path.name
      - text: Show recorded request {requestHistoryName}.
        slots:
          requestHistoryName: path.requestHistoryName
      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}/runs/{runName}/actions/{actionName}/scopeRepetitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List scoped repetitions of a workflow action
      effect: read
      questions:
      - How do I list the scope repetitions of a scope or until action in a run?
      - Which scoped iterations ran inside an action?
      instructions:
      - text: For scope action {actionName} in run {runName} of {workflowName} on {name}, list its scope repetitions.
        slots:
          actionName: path.actionName
          runName: path.runName
          workflowName: path.workflowName
          name: path.name
      - text: Show the scope repetitions for action {actionName}.
        slots:
          actionName: path.actionName
      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}/runs/{runName}/actions/{actionName}/scopeRepetitions/{repetitionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one scoped repetition of a workflow action
      effect: read
      questions:
      - How do I inspect a single scoped repetition of an action?
      - What were the results of one scope iteration?
      instructions:
      - text: Fetch scope-level repetition {repetitionName} under scope action {actionName}, run {runName}, workflow {workflowName}, app {name}.
        slots:
          repetitionName: path.repetitionName
          actionName: path.actionName
          runName: path.runName
          workflowName: path.workflowName
          name: path.name
      - text: Show scope repetition {repetitionName}.
        slots:
          repetitionName: path.repetitionName
      method: generated
      generated: '2026-10-01'