# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DataFactoryManagementClient Triggers API
  version: 1.0.0
extends: openapi/microsoft-azure-data-factory-triggers-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: 9
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/querytriggers'].post
  update:
    x-apievangelist-phrasing:
      intent: Search triggers in a factory
      effect: read
      questions:
      - Can I find the child triggers that belong to a parent trigger?
      - Which triggers match my query in a factory, page by page?
      instructions:
      - text: Query triggers in factory {factory} with parent trigger {parent}.
        slots:
          factory: path.factoryName
          parent: requestBody.parentTriggerName
      - text: Get the next page of trigger query results in {factory} using token {token}.
        slots:
          factory: path.factoryName
          token: requestBody.continuationToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/triggers'].get
  update:
    x-apievangelist-phrasing:
      intent: List triggers in a factory
      effect: read
      questions:
      - What triggers are defined in my data factory?
      - Can I list every schedule and event trigger in a factory?
      instructions:
      - text: List the triggers in factory {factory}.
        slots:
          factory: path.factoryName
      - text: Show all triggers defined in {factory}.
        slots:
          factory: path.factoryName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/triggers/{triggerName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a trigger
      effect: write
      questions:
      - How do I create a schedule trigger that runs my pipeline every night?
      - Can I change an existing trigger's definition with an ETag check?
      instructions:
      - text: Create trigger {trigger} in factory {factory} with properties {properties}.
        slots:
          factory: path.factoryName
          trigger: path.triggerName
          properties: requestBody.properties
      - text: Update trigger {trigger} in {factory} to {properties} if its ETag is {etag}.
        slots:
          factory: path.factoryName
          trigger: path.triggerName
          properties: requestBody.properties
          etag: header.if-match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/triggers/{triggerName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a trigger
      effect: destructive
      questions:
      - Can I delete a trigger I no longer need?
      - What removes a trigger definition from a factory?
      instructions:
      - text: Delete trigger {trigger} from factory {factory}.
        slots:
          factory: path.factoryName
          trigger: path.triggerName
      - text: Remove the {trigger} trigger in {factory}.
        slots:
          factory: path.factoryName
          trigger: path.triggerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/triggers/{triggerName}/getEventSubscriptionStatus'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a trigger's event subscription status
      effect: read
      questions:
      - Is my event trigger subscribed to events yet, or still provisioning?
      - What is the event subscription status of a storage event trigger?
      instructions:
      - text: Get the event subscription status of trigger {trigger} in factory {factory}.
        slots:
          factory: path.factoryName
          trigger: path.triggerName
      - text: Check whether trigger {trigger} has finished subscribing to events.
        slots:
          trigger: path.triggerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/triggers/{triggerName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a trigger
      effect: write
      questions:
      - How do I activate a trigger so it starts firing pipelines?
      - Can I start a stopped trigger?
      instructions:
      - text: Start trigger {trigger} in factory {factory}.
        slots:
          factory: path.factoryName
          trigger: path.triggerName
      - text: Activate trigger {trigger} so it begins firing.
        slots:
          trigger: path.triggerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/triggers/{triggerName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a trigger
      effect: write
      questions:
      - How do I pause a trigger so it stops firing pipelines?
      - Can I stop a trigger without deleting it?
      instructions:
      - text: Stop trigger {trigger} in factory {factory}.
        slots:
          factory: path.factoryName
          trigger: path.triggerName
      - text: Pause trigger {trigger} but keep its definition.
        slots:
          trigger: path.triggerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/triggers/{triggerName}/subscribeToEvents'].post
  update:
    x-apievangelist-phrasing:
      intent: Subscribe an event trigger to events
      effect: write
      questions:
      - How do I subscribe an event trigger to its storage events?
      - Can I register an event trigger's subscription manually?
      instructions:
      - text: Subscribe event trigger {trigger} in factory {factory} to events.
        slots:
          factory: path.factoryName
          trigger: path.triggerName
      - text: Register the event subscription for trigger {trigger}.
        slots:
          trigger: path.triggerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/triggers/{triggerName}/unsubscribeFromEvents'].post
  update:
    x-apievangelist-phrasing:
      intent: Unsubscribe an event trigger from events
      effect: write
      questions:
      - How do I unsubscribe an event trigger from its events?
      - Can I remove an event trigger's subscription without deleting the trigger?
      instructions:
      - text: Unsubscribe event trigger {trigger} in factory {factory} from events.
        slots:
          factory: path.factoryName
          trigger: path.triggerName
      - text: Remove the event subscription for trigger {trigger}.
        slots:
          trigger: path.triggerName
      method: generated
      generated: '2026-09-26'