Cvent Registration · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Cvent REST Seating API

9 actions 9 updates phrasing extends openapi/cvent-registration-seating-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Cvent Registration's API. It is a proposal applied on top of the contract, not a document Cvent Registration publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 9

$.info
$.paths['/events/{id}/seatings'].get
$.paths['/events/{id}/seatings/assignments'].get
$.paths['/events/{id}/seatings/{seatingId}'].get
$.paths['/events/{id}/seatings/{seatingId}/assignments'].get
$.paths['/events/{id}/seatings/{seatingId}/tables'].get
$.paths['/events/{id}/seatings/{seatingId}/tables/{tableId}'].get
$.paths['/events/{id}/seatings/{seatingId}/tables/{tableId}/seats'].get
$.paths['/events/{id}/seatings/{seatingId}/tables/{tableId}/seats/{seatId}'].get

OpenAPI Overlay

Raw ↑
# 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-registration-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 an event's seating charts?
      instructions:
      - text: List the seating charts for event {id}.
        slots:
          id: path.id
      - text: Show event {id} seatings 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:
      - Who is assigned to which table across every seating chart in 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} matching {filter}.
        slots:
          id: path.id
          filter: query.filter
      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 specific seating chart?
      - Can I look up a seating by its ID?
      instructions:
      - text: Get seating {seatingId} in event {id}.
        slots:
          seatingId: path.seatingId
          id: path.id
      - text: Show the configuration of seating chart {seatingId} for 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 assignments within one seating
      effect: read
      questions:
      - Who is seated where in one particular seating chart?
      - Can I list table assignments for just a single seating?
      instructions:
      - text: List table assignments for seating {seatingId} in event {id}.
        slots:
          seatingId: path.seatingId
          id: path.id
      - text: Show who is assigned in seating chart {seatingId} only, event {id}.
        slots:
          seatingId: path.seatingId
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{id}/seatings/{seatingId}/tables'].get
  update:
    x-apievangelist-phrasing:
      intent: List the tables in a seating
      effect: read
      questions:
      - Which tables are in a seating chart?
      - Can I filter the tables of a seating?
      instructions:
      - text: List tables in seating {seatingId} for event {id}.
        slots:
          seatingId: path.seatingId
          id: path.id
      - text: Show tables 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/{tableId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one table's details
      effect: read
      questions:
      - What are the details of a particular table in a seating?
      - Can I look up a single table by its ID?
      instructions:
      - text: Get table {tableId} in seating {seatingId} for event {id}.
        slots:
          tableId: path.tableId
          seatingId: path.seatingId
          id: path.id
      - text: Show the info for table {tableId}, seating {seatingId}, 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 the seats at a table
      effect: read
      questions:
      - Which seats are at a given table?
      - Can I filter the seats at a table?
      instructions:
      - text: List seats at table {tableId} in seating {seatingId}, 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 do we know about a specific seat at a table?
      - Can I look up a single seat by its ID?
      instructions:
      - text: Get seat {seatId} at table {tableId}, seating {seatingId}, event {id}.
        slots:
          seatId: path.seatId
          tableId: path.tableId
          seatingId: path.seatingId
          id: path.id
      - text: Show the details of seat {seatId} on table {tableId} in seating {seatingId} for event {id}.
        slots:
          seatId: path.seatId
          tableId: path.tableId
          seatingId: path.seatingId
          id: path.id
      method: generated
      generated: '2026-09-26'