# 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 Triggers API
  version: 1.0.0
extends: openapi/microsoft-azure-workflow-triggers-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: 13
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/triggers'].get
  update:
    x-apievangelist-phrasing:
      intent: List a Logic App workflow's triggers
      effect: read
      questions:
      - Which triggers are defined on my Consumption Logic App workflow?
      - Can I filter or cap the number of triggers returned for a Logic Apps workflow?
      instructions:
      - text: List the triggers on Logic App workflow {workflowName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the first {top} triggers of Logic Apps workflow {workflowName} in {resourceGroupName}.
        slots:
          top: query.$top
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/triggers/{triggerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Logic App workflow trigger
      effect: read
      questions:
      - Where can I see the configuration of one trigger on a Consumption Logic App?
      - What state is a specific Logic Apps workflow trigger in?
      instructions:
      - text: Get trigger {triggerName} of Logic App workflow {workflowName} in {resourceGroupName} under subscription {subscriptionId}.
        slots:
          triggerName: path.triggerName
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the details of Logic Apps trigger {triggerName} on workflow {workflowName} ({resourceGroupName}).
        slots:
          triggerName: path.triggerName
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/triggers/{triggerName}/reset'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset a Logic App workflow trigger
      effect: write
      questions:
      - Can I reset a Logic App trigger's state so it starts fresh?
      - Can I clear a polling trigger's stored state on a workflow?
      instructions:
      - text: Reset trigger {triggerName} on workflow {workflowName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          triggerName: path.triggerName
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Clear the state of Logic App trigger {triggerName} for workflow {workflowName}, resource group {resourceGroupName}.
        slots:
          triggerName: path.triggerName
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/triggers/{triggerName}/run'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a Logic App workflow trigger now
      effect: write
      questions:
      - How do I manually fire a trigger on a Consumption Logic App workflow?
      - Can I kick off a Logic Apps run on demand without waiting for the schedule?
      instructions:
      - text: Run trigger {triggerName} of Logic App workflow {workflowName} in {resourceGroupName} ({subscriptionId}) now.
        slots:
          triggerName: path.triggerName
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Manually fire Logic Apps trigger {triggerName} on {workflowName} in resource group {resourceGroupName}.
        slots:
          triggerName: path.triggerName
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/triggers/{triggerName}/schemas/json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Logic App trigger's JSON schema
      effect: read
      questions:
      - What payload shape does my Logic App's request trigger expect?
      - Can I download the JSON schema of a Consumption workflow trigger?
      instructions:
      - text: Get the JSON schema for trigger {triggerName} on Logic App workflow {workflowName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          triggerName: path.triggerName
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the expected request body schema of Logic Apps trigger {triggerName}, workflow {workflowName}, group {resourceGroupName}.
        slots:
          triggerName: path.triggerName
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/triggers/{triggerName}/setState'].post
  update:
    x-apievangelist-phrasing:
      intent: Set a trigger's state from another trigger
      effect: write
      questions:
      - Can I copy the state of one workflow trigger onto another?
      - Is it possible to set a Logic App trigger's state from a source trigger?
      instructions:
      - text: Set the state of trigger {triggerName} on workflow {workflowName} in {resourceGroupName} ({subscriptionId}) from source trigger {source}.
        slots:
          triggerName: path.triggerName
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          source: requestBody.source
          subscriptionId: path.subscriptionId
      - text: Copy trigger state from {source} onto {triggerName} of workflow {workflowName} ({resourceGroupName}).
        slots:
          source: requestBody.source
          triggerName: path.triggerName
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/triggers/{triggerName}/listCallbackUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a Logic App trigger's callback URL
      effect: read
      questions:
      - Where do I find the HTTP endpoint URL that invokes my Consumption Logic App?
      - How can I get the signed callback URL for a Logic Apps request trigger?
      instructions:
      - text: Get the callback URL for trigger {triggerName} of Logic App workflow {workflowName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          triggerName: path.triggerName
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Give me the invoke URL of Logic Apps trigger {triggerName} on {workflowName}, resource group {resourceGroupName}.
        slots:
          triggerName: path.triggerName
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/versions/{versionId}/triggers/{triggerName}/listCallbackUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a trigger callback URL for a workflow version
      effect: read
      questions:
      - Can I get the callback URL for a trigger on an older version of my workflow?
      - What expiry can I put on a version-specific trigger callback URL?
      instructions:
      - text: Get the callback URL for trigger {triggerName} in version {versionId} of workflow {workflowName} ({resourceGroupName}, {subscriptionId}).
        slots:
          triggerName: path.triggerName
          versionId: path.versionId
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Get a callback URL for trigger {triggerName}, workflow {workflowName} version {versionId} in {resourceGroupName}, valid until {notAfter}.
        slots:
          triggerName: path.triggerName
          workflowName: path.workflowName
          versionId: path.versionId
          resourceGroupName: path.resourceGroupName
          notAfter: requestBody.notAfter
      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}/triggers'].get
  update:
    x-apievangelist-phrasing:
      intent: List triggers of a Standard logic app workflow
      effect: read
      questions:
      - Which triggers exist on a workflow hosted inside my Standard logic app site?
      - Can I list workflow triggers through an App Service site's host runtime?
      instructions:
      - text: List triggers of workflow {workflowName} hosted in site {name} ({resourceGroupName}, subscription {subscriptionId}).
        slots:
          workflowName: path.workflowName
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the top {top} triggers for Standard workflow {workflowName} on app {name}, group {resourceGroupName}.
        slots:
          top: query.$top
          workflowName: path.workflowName
          name: path.name
          resourceGroupName: path.resourceGroupName
      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}/triggers/{triggerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a trigger on a Standard logic app workflow
      effect: read
      questions:
      - How do I inspect one trigger of a workflow running in a Standard logic app?
      - Can I read a site-hosted workflow trigger's definition through the host runtime?
      instructions:
      - text: Get trigger {triggerName} of workflow {workflowName} hosted in site {name} ({resourceGroupName}, {subscriptionId}).
        slots:
          triggerName: path.triggerName
          workflowName: path.workflowName
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show Standard logic app {name}'s trigger {triggerName} on workflow {workflowName}, group {resourceGroupName}.
        slots:
          name: path.name
          triggerName: path.triggerName
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
      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}/triggers/{triggerName}/listCallbackUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a Standard workflow trigger's callback URL
      effect: read
      questions:
      - Where is the callback URL for a request trigger in my Standard logic app site?
      - What's the invoke endpoint for a workflow hosted on an App Service site?
      instructions:
      - text: Get the callback URL for trigger {triggerName} on site {name}'s workflow {workflowName} ({resourceGroupName}, {subscriptionId}).
        slots:
          triggerName: path.triggerName
          name: path.name
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Give me the Standard logic app {name} invoke URL for {workflowName}/{triggerName} in {resourceGroupName}.
        slots:
          name: path.name
          workflowName: path.workflowName
          triggerName: path.triggerName
          resourceGroupName: path.resourceGroupName
      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}/triggers/{triggerName}/run'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a trigger on a Standard logic app workflow
      effect: write
      questions:
      - Can I manually run a trigger on a workflow inside a Standard logic app?
      - Can I fire a site-hosted workflow trigger on demand?
      instructions:
      - text: Run trigger {triggerName} of workflow {workflowName} hosted in site {name} ({resourceGroupName}, {subscriptionId}).
        slots:
          triggerName: path.triggerName
          workflowName: path.workflowName
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Fire Standard logic app {name}'s workflow {workflowName} trigger {triggerName} now, group {resourceGroupName}.
        slots:
          name: path.name
          workflowName: path.workflowName
          triggerName: path.triggerName
          resourceGroupName: path.resourceGroupName
      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}/triggers/{triggerName}/schemas/json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Standard workflow trigger's JSON schema
      effect: read
      questions:
      - What request schema does a trigger in my Standard logic app workflow expect?
      - Can I fetch a site-hosted workflow trigger's schema as JSON?
      instructions:
      - text: Get the JSON schema of trigger {triggerName} on site {name}'s workflow {workflowName} ({resourceGroupName}, {subscriptionId}).
        slots:
          triggerName: path.triggerName
          name: path.name
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the payload schema for Standard logic app {name}, workflow {workflowName}, trigger {triggerName} in {resourceGroupName}.
        slots:
          name: path.name
          workflowName: path.workflowName
          triggerName: path.triggerName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'