# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cvent REST Discounts API
  version: 1.0.0
extends: openapi/cvent-registration-discounts-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: 6
- target: $.paths['/events/{id}/discounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List an event's discounts
      effect: read
      questions:
      - Which discount codes are in use for my event, including account-level ones?
      - Can I sort or filter an event's discounts?
      instructions:
      - text: List the discounts for event {id}.
        slots:
          id: path.id
      - text: List event {id} discounts matching {filter}, sorted by {sort}.
        slots:
          id: path.id
          filter: query.filter
          sort: query.sort
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{id}/discounts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a discount in an event
      effect: write
      questions:
      - How do I add a new discount code to an event?
      - Can I create an event-specific discount through the API?
      instructions:
      - text: Create a new discount in event {id}.
        slots:
          id: path.id
      - text: Add this discount code to event {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{id}/discounts/agenda-items'].get
  update:
    x-apievangelist-phrasing:
      intent: List agenda items tied to discounts
      effect: read
      questions:
      - Which sessions or admission items currently have a discount applied in my event?
      - Can I see which agenda items each discount covers?
      instructions:
      - text: List the discounted agenda items in event {id}.
        slots:
          id: path.id
      - text: List event {id} agenda items linked to discounts matching {filter}.
        slots:
          id: path.id
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{id}/discounts/{discountId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an event discount
      effect: write
      questions:
      - How do I change an existing discount in my event?
      - Do fields I leave out revert to defaults when updating a discount?
      instructions:
      - text: Update discount {discountId} in event {id}.
        slots:
          discountId: path.discountId
          id: path.id
      - text: Replace the settings of discount {discountId} for event {id}.
        slots:
          discountId: path.discountId
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{id}/discounts/{discountId}/agenda-items/{agendaItemId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Apply a discount to an agenda item
      effect: write
      questions:
      - How do I make a discount apply to a specific session or admission item?
      - Can I link one agenda item to an event discount?
      instructions:
      - text: Link agenda item {agendaItemId} to discount {discountId} in event {id}.
        slots:
          agendaItemId: path.agendaItemId
          discountId: path.discountId
          id: path.id
      - text: Apply discount {discountId} to agenda item {agendaItemId} for event {id}.
        slots:
          discountId: path.discountId
          agendaItemId: path.agendaItemId
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{id}/discounts/{discountId}/agenda-items/{agendaItemId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a discount from an agenda item
      effect: destructive
      questions:
      - How do I stop a discount from applying to one agenda item?
      - Can I unlink an agenda item from a discount without deleting the discount?
      instructions:
      - text: Unlink agenda item {agendaItemId} from discount {discountId} in event {id}.
        slots:
          agendaItemId: path.agendaItemId
          discountId: path.discountId
          id: path.id
      - text: Stop discount {discountId} applying to agenda item {agendaItemId} in event {id}.
        slots:
          discountId: path.discountId
          agendaItemId: path.agendaItemId
          id: path.id
      method: generated
      generated: '2026-09-26'