# 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 Seating API
  version: 1.0.0
extends: openapi/cvent-event-cloud-seating-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: 8
- target: $.paths['/events/{id}/seatings'].get
  update:
    x-apievangelist-phrasing:
      intent: List an event's seating charts
      effect: read
      questions:
      - What seating arrangements are set up for my event?
      - Can I filter the seatings for an event?
      instructions:
      - text: List the seatings for event {id}.
        slots:
          id: path.id
      - text: Show seating charts on event {id} matching {filter}.
        slots:
          id: path.id
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{id}/seatings/assignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List table assignments across all seatings
      effect: read
      questions:
      - Where is every guest seated across all the seating charts of my event?
      - Can I get all table assignments for an event in one call?
      instructions:
      - text: List all table assignments across every seating in event {id}.
        slots:
          id: path.id
      - text: Show event-wide seat assignments for event {id} with {expand} expanded.
        slots:
          id: path.id
          expand: query.expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{id}/seatings/{seatingId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one seating chart
      effect: read
      questions:
      - What are the details of a single seating chart?
      - Can I look up one seating by its ID?
      instructions:
      - text: Get seating {seatingId} for event {id}.
        slots:
          seatingId: path.seatingId
          id: path.id
      - text: Show the setup of seating chart {seatingId} on event {id}.
        slots:
          seatingId: path.seatingId
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{id}/seatings/{seatingId}/assignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List table assignments in one seating
      effect: read
      questions:
      - Who is assigned to tables in a particular seating chart?
      - Can I see assignments for just the gala dinner seating?
      instructions:
      - text: List table assignments in seating {seatingId} of event {id}.
        slots:
          seatingId: path.seatingId
          id: path.id
      - text: Show who sits where in seating {seatingId}, event {id}, matching {filter}.
        slots:
          seatingId: path.seatingId
          id: path.id
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{id}/seatings/{seatingId}/tables'].get
  update:
    x-apievangelist-phrasing:
      intent: List tables in a seating
      effect: read
      questions:
      - What tables are in a seating chart?
      - How many tables does a given seating have?
      instructions:
      - text: List tables in seating {seatingId} for event {id}.
        slots:
          seatingId: path.seatingId
          id: path.id
      - text: Show tables of seating {seatingId} on event {id} with {expand} expanded.
        slots:
          seatingId: path.seatingId
          id: path.id
          expand: query.expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{id}/seatings/{seatingId}/tables/{tableId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one table's details
      effect: read
      questions:
      - What are the details of a specific table?
      - Can I look up a single table in a seating chart?
      instructions:
      - text: Get table {tableId} in seating {seatingId} of event {id}.
        slots:
          tableId: path.tableId
          seatingId: path.seatingId
          id: path.id
      - text: Describe table {tableId} of seating chart {seatingId} at event {id}.
        slots:
          tableId: path.tableId
          seatingId: path.seatingId
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{id}/seatings/{seatingId}/tables/{tableId}/seats'].get
  update:
    x-apievangelist-phrasing:
      intent: List seats at a table
      effect: read
      questions:
      - Which seats are at a particular table?
      - Can I filter seats at a table?
      instructions:
      - text: List seats at table {tableId} in seating {seatingId} of event {id}.
        slots:
          tableId: path.tableId
          seatingId: path.seatingId
          id: path.id
      - text: Show seats at table {tableId}, seating {seatingId}, event {id}, matching {filter}.
        slots:
          tableId: path.tableId
          seatingId: path.seatingId
          id: path.id
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{id}/seatings/{seatingId}/tables/{tableId}/seats/{seatId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one seat's details
      effect: read
      questions:
      - What are the details of a single seat?
      - Can I check one specific seat at a table?
      instructions:
      - text: Get seat {seatId} at table {tableId} in seating {seatingId} of event {id}.
        slots:
          seatId: path.seatId
          tableId: path.tableId
          seatingId: path.seatingId
          id: path.id
      - text: Look up individual seat {seatId} at table {tableId} (seating {seatingId}, event {id}).
        slots:
          seatId: path.seatId
          tableId: path.tableId
          seatingId: path.seatingId
          id: path.id
      method: generated
      generated: '2026-09-26'