API Evangelist conversational phrasing for Zendesk Triggers API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Zendesk Triggers API
  version: 1.0.0
extends: openapi/zendesk-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: 13
- target: $.paths['/api/v2/triggers/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search ticket triggers
      effect: read
      questions:
      - Can I search my ticket triggers by a keyword?
      - Which triggers mention a certain word in their title?
      instructions:
      - text: Search triggers for the word escalation.
      - text: Find ticket triggers whose name matches VIP.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/triggers'].get
  update:
    x-apievangelist-phrasing:
      intent: List all ticket triggers
      effect: read
      questions:
      - What ticket triggers exist in my account, active or not?
      - Can I page through every ticket trigger 100 at a time?
      instructions:
      - text: List all ticket triggers, including inactive ones.
      - text: Show every business rule trigger in the account.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/triggers'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a ticket trigger
      effect: write
      questions:
      - Can I set up a rule that fires automatically when a ticket changes?
      - What does it take to add a new trigger with conditions and actions?
      instructions:
      - text: Create a trigger that notifies the requester when a ticket is solved.
      - text: Add a new ticket trigger that assigns urgent tickets to Tier 2.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/triggers/{trigger_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a ticket trigger
      effect: read
      questions:
      - Where can I see the conditions and actions of one trigger?
      - Why does a trigger's via type show up as a number?
      instructions:
      - text: Show me the details of this trigger.
      - text: Get the conditions and actions for the escalation trigger.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/triggers/{trigger_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a ticket trigger
      effect: write
      questions:
      - If I change one condition on a trigger, do I lose the existing actions?
      - Can I rename or edit the actions of an existing trigger?
      instructions:
      - text: Update this trigger's conditions, keeping all of its actions.
      - text: Edit the escalation trigger to also add the urgent tag.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/triggers/{trigger_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a ticket trigger
      effect: destructive
      questions:
      - Can I remove a single trigger I no longer need?
      - What happens to tickets when I delete one trigger?
      instructions:
      - text: Delete this ticket trigger.
      - text: Remove the old welcome email trigger.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/triggers/{trigger_id}/revisions'].get
  update:
    x-apievangelist-phrasing:
      intent: List a trigger's revision history
      effect: read
      questions:
      - Can I see who changed a trigger and when?
      - Is trigger revision history only on Enterprise plans?
      instructions:
      - text: List the revisions of this trigger.
      - text: Show the change history for the escalation trigger.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/triggers/{trigger_id}/revisions/{trigger_revision_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one revision of a trigger
      effect: read
      questions:
      - What did a trigger look like at a specific earlier revision?
      - Can I fetch a single past version of a trigger?
      instructions:
      - text: Show me that specific revision of the trigger.
      - text: Fetch revision 3 of the escalation trigger.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/triggers/active'].get
  update:
    x-apievangelist-phrasing:
      intent: List active ticket triggers
      effect: read
      questions:
      - Which triggers are currently switched on?
      - Can I see only the triggers that are active right now?
      instructions:
      - text: List the active ticket triggers.
      - text: Show only enabled triggers.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/triggers/definitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List trigger condition and action definitions
      effect: read
      questions:
      - What conditions and actions can a trigger use?
      - Which values are allowed for a trigger condition like status?
      instructions:
      - text: List the available trigger conditions and actions.
      - text: Show the definitions I can use to build a trigger.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/triggers/destroy_many'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete several triggers at once
      effect: destructive
      questions:
      - Can I remove a list of triggers by id in one request?
      - Is there a bulk delete for old triggers?
      instructions:
      - text: Delete these triggers by id in bulk.
      - text: Remove all of the obsolete triggers in this list together.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/triggers/reorder'].put
  update:
    x-apievangelist-phrasing:
      intent: Change the firing order of triggers
      effect: write
      questions:
      - Can I control which trigger fires first?
      - How does trigger order affect what happens to a ticket?
      instructions:
      - text: Reorder the triggers so the escalation rule fires first.
      - text: Set the firing order of triggers to this sequence.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/triggers/update_many'].put
  update:
    x-apievangelist-phrasing:
      intent: Update position or active status of many triggers
      effect: write
      questions:
      - Can I activate or deactivate several triggers in one call?
      - Which trigger properties can a bulk update change?
      instructions:
      - text: Deactivate these triggers in bulk.
      - text: Update the position and active flag for this set of triggers.
      method: generated
      generated: '2026-09-26'