# 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 Workflows API
  version: 1.0.0
extends: openapi/microsoft-azure-workflows-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: 21
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Logic/workflows'].get
  update:
    x-apievangelist-phrasing:
      intent: List Logic Apps workflows across a subscription
      effect: read
      questions:
      - Which Logic Apps workflows exist anywhere in my Azure subscription?
      - Can I filter the subscription-wide list of Logic Apps workflows and cap how many come back?
      instructions:
      - text: List every Logic Apps workflow in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show the first {top} Logic Apps workflows in my subscription matching {filter}.
        slots:
          top: query.$top
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows'].get
  update:
    x-apievangelist-phrasing:
      intent: List Logic Apps workflows in a resource group
      effect: read
      questions:
      - What Logic Apps workflows are deployed in one particular resource group?
      - Is there a way to filter the workflows inside a single resource group by state?
      instructions:
      - text: List the Logic Apps workflows in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show up to {top} workflows in resource group {resourceGroupName} filtered by {filter}.
        slots:
          top: query.$top
          resourceGroupName: path.resourceGroupName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Logic Apps workflow
      effect: read
      questions:
      - How do I look up the details of one Logic Apps workflow by its name?
      - What does the definition and state of my Logic Apps workflow look like right now?
      instructions:
      - text: Get Logic Apps workflow {workflowName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show me the current definition of the {workflowName} logic app.
        slots:
          workflowName: path.workflowName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a Logic Apps workflow
      effect: write
      questions:
      - How do I deploy a new Logic Apps workflow into a resource group?
      - Can I overwrite a Logic Apps workflow with a full new definition in one call?
      instructions:
      - text: Create Logic Apps workflow {workflowName} in resource group {resourceGroupName} of subscription {subscriptionId} in region {location}.
        slots:
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          location: requestBody.location
      - text: 'Replace the full definition of logic app {workflowName} with these properties: {properties}.'
        slots:
          workflowName: path.workflowName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Logic Apps workflow
      effect: destructive
      questions:
      - How do I permanently remove a Logic Apps workflow I no longer need?
      - Can I delete a logic app from a resource group through the management API?
      instructions:
      - text: Delete Logic Apps workflow {workflowName} from resource group {resourceGroupName} in subscription {subscriptionId}.
        slots:
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove the {workflowName} logic app entirely.
        slots:
          workflowName: path.workflowName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an existing Logic Apps workflow
      effect: write
      questions:
      - Can I change just the tags on an existing Logic Apps workflow without redeploying it?
      - What's the way to partially update a logic app that already exists?
      instructions:
      - text: Update the tags on existing logic app {workflowName} in {resourceGroupName}, subscription {subscriptionId}, to {tags}.
        slots:
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          tags: requestBody.tags
      - text: Patch the properties of existing workflow {workflowName} with {properties}.
        slots:
          workflowName: path.workflowName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/disable'].post
  update:
    x-apievangelist-phrasing:
      intent: Disable a Logic Apps workflow
      effect: write
      questions:
      - How do I stop a logic app from firing its triggers without deleting it?
      - Can I turn off a Logic Apps workflow temporarily?
      instructions:
      - text: Disable logic app {workflowName} in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Pause the {workflowName} workflow so its triggers stop running.
        slots:
          workflowName: path.workflowName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/enable'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable a disabled Logic Apps workflow
      effect: write
      questions:
      - How do I switch a disabled logic app back on?
      - Can I re-enable a Logic Apps workflow that I turned off earlier?
      instructions:
      - text: Enable logic app {workflowName} in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Turn the {workflowName} workflow back on.
        slots:
          workflowName: path.workflowName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/generateUpgradedDefinition'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate an upgraded workflow definition
      effect: read
      questions:
      - Can Azure produce an upgraded version of my logic app definition for a newer schema?
      - What would my Logic Apps workflow definition look like upgraded to a target schema version?
      instructions:
      - text: Generate an upgraded definition of logic app {workflowName} targeting schema version {targetSchemaVersion}.
        slots:
          workflowName: path.workflowName
          targetSchemaVersion: requestBody.targetSchemaVersion
      - text: Produce the upgraded definition for workflow {workflowName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/listCallbackUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a logic app's callback URL
      effect: read
      questions:
      - Where do I find the callback URL for calling my logic app over HTTP?
      - Can I get a workflow callback URL that expires at a specific time?
      instructions:
      - text: Get the callback URL for logic app {workflowName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Give me a callback URL for workflow {workflowName} valid until {notAfter} using the {keyType} key.
        slots:
          workflowName: path.workflowName
          notAfter: requestBody.notAfter
          keyType: requestBody.keyType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/listSwagger'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an OpenAPI definition for a logic app
      effect: read
      questions:
      - Can I get a Swagger or OpenAPI description of my Logic Apps workflow?
      - Is there a machine-readable API definition for calling my logic app?
      instructions:
      - text: Get the OpenAPI definition for logic app {workflowName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Export the Swagger for workflow {workflowName}.
        slots:
          workflowName: path.workflowName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/move'].post
  update:
    x-apievangelist-phrasing:
      intent: Move a Logic Apps workflow
      effect: write
      questions:
      - How do I move an existing logic app to another resource group or subscription?
      - Can I relocate a Logic Apps workflow without rebuilding it?
      instructions:
      - text: Move logic app {workflowName} from resource group {resourceGroupName} to the target resource {id}.
        slots:
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          id: requestBody.id
      - text: Relocate workflow {workflowName} out of {resourceGroupName} in subscription {subscriptionId}.
        slots:
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/regenerateAccessKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a consumption logic app's access key
      effect: write
      questions:
      - How do I rotate the access key on a consumption Logic Apps workflow?
      - Can I regenerate the primary or secondary key of a Microsoft.Logic workflow?
      instructions:
      - text: Regenerate the {keyType} access key for consumption logic app {workflowName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          keyType: requestBody.keyType
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Rotate the access key on Microsoft.Logic workflow {workflowName}.
        slots:
          workflowName: path.workflowName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a logic app in its resource group
      effect: read
      questions:
      - Can I check a consumption logic app definition for errors before saving it to its resource group?
      - Will my Logic Apps workflow pass validation in the resource group it belongs to?
      instructions:
      - text: Validate logic app {workflowName} in resource group {resourceGroupName} of subscription {subscriptionId} with properties {properties}.
        slots:
          workflowName: path.workflowName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      - text: Check that resource-group workflow {workflowName} is valid before I deploy it.
        slots:
          workflowName: path.workflowName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/locations/{location}/workflows/{workflowName}/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a logic app definition for a region
      effect: read
      questions:
      - Can I validate a Logic Apps workflow definition against a specific Azure region?
      - Is my logic app definition valid for deployment in a given location?
      instructions:
      - text: Validate the definition of logic app {workflowName} for region {location} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          workflowName: path.workflowName
          location: path.location
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Check whether workflow {workflowName} would validate in location {location}.
        slots:
          workflowName: path.workflowName
          location: path.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workflows'].get
  update:
    x-apievangelist-phrasing:
      intent: List all workflows by workflow ID
      effect: read
      questions:
      - What workflows exist in the standalone workflows service, keyed by workflow ID?
      - Can I see every workflow along with its triggers and enabled state?
      instructions:
      - text: List all workflows registered in the workflows service.
      - text: Show every workflow ID I have defined, using API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workflows/{workflowId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workflow by ID
      effect: read
      questions:
      - How do I fetch one workflow from the workflows service by its workflow ID?
      - What triggers and actions does a given workflow ID have?
      instructions:
      - text: Get workflow {workflowId}.
        slots:
          workflowId: path.workflowId
      - text: Show the triggers and action graph for workflow ID {workflowId}.
        slots:
          workflowId: path.workflowId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workflows/{workflowId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a workflow by ID
      effect: write
      questions:
      - How do I define a new workflow with a name, description, triggers and an enabled flag?
      - Can I replace an existing workflow ID with a fresh set of triggers?
      instructions:
      - text: Create workflow {workflowId} named {name} described as {description} with triggers {triggers}, enabled {isEnabled}.
        slots:
          workflowId: path.workflowId
          name: requestBody.name
          description: requestBody.description
          triggers: requestBody.triggers
          isEnabled: requestBody.isEnabled
      - text: Replace workflow ID {workflowId} with the action graph {actionDag}.
        slots:
          workflowId: path.workflowId
          actionDag: requestBody.actionDag
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workflows/{workflowId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a workflow by ID
      effect: destructive
      questions:
      - How do I remove a workflow from the workflows service using its ID?
      - Can a workflow ID be deleted once I stop needing it?
      instructions:
      - text: Delete workflow ID {workflowId}.
        slots:
          workflowId: path.workflowId
      - text: Remove workflow {workflowId} and its triggers.
        slots:
          workflowId: path.workflowId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hostruntime/runtime/webhooks/workflow/api/management/workflows/{workflowName}/regenerateAccessKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a Standard logic app trigger key
      effect: write
      questions:
      - How do I regenerate the callback URL access key for request triggers on a Standard logic app site?
      - Can I rotate the trigger key of a workflow hosted in an App Service logic app?
      instructions:
      - text: Regenerate the {keyType} request-trigger key for workflow {workflowName} on site {name} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          keyType: requestBody.keyType
          workflowName: path.workflowName
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Rotate the callback URL key for workflow {workflowName} running on logic app site {name}.
        slots:
          workflowName: path.workflowName
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hostruntime/runtime/webhooks/workflow/api/management/workflows/{workflowName}/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a workflow on a Standard logic app site
      effect: read
      questions:
      - Can I validate a workflow definition hosted on a Standard logic app site before saving it?
      - Will a workflow on my App Service logic app site pass definition validation?
      instructions:
      - text: Validate workflow {workflowName} on logic app site {name} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          workflowName: path.workflowName
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Check the definition {properties} for workflow {workflowName} on site {name}.
        slots:
          properties: requestBody.properties
          workflowName: path.workflowName
          name: path.name
      method: generated
      generated: '2026-09-26'