Cvent · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Cvent REST Seating API

9 actions 9 updates phrasing extends openapi/cvent-seating-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Cvent's API. It is a proposal applied on top of the contract, not a document Cvent 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-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 seating charts for an event
      effect: read
      questions:
      - What seating charts are set up for my event?
      - Can I filter the seating plans on an event?
      instructions:
      - text: List the seating charts for event {id}.
        slots:
          id: path.id
      - text: Show seating plans in 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 attendee seated across all seating charts at 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 plan by its ID?
      instructions:
      - text: Get seating {seatingId} for event {id}.
        slots:
          seatingId: path.seatingId
          id: path.id
      - text: Show seating chart {seatingId} at 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 one particular seating chart?
      - Can I see assignments for a single dinner seating only?
      instructions:
      - text: List table assignments for seating {seatingId} in event {id}.
        slots:
          seatingId: path.seatingId
          id: path.id
      - text: Show who sits where in seating {seatingId} at 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 tables in a seating chart
      effect: read
      questions:
      - How many tables are in a seating chart?
      - Can I list the tables of one seating with details expanded?
      instructions:
      - text: List tables in seating {seatingId} for event {id}.
        slots:
          seatingId: path.seatingId
          id: path.id
      - text: Show tables of seating {seatingId}, 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 in a seating chart
      effect: read
      questions:
      - What are the details of a specific table in a seating chart?
      - Can I look up one 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 table {tableId} from seating {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 given table?
      - Can I filter the seats at one 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 all seats around table {tableId} for seating {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/{seatId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one seat
      effect: read
      questions:
      - What are the details of a single seat at a table?
      - Can I look up one specific seat by ID?
      instructions:
      - text: Get seat {seatId} at table {tableId} in seating {seatingId}, event {id}.
        slots:
          seatId: path.seatId
          tableId: path.tableId
          seatingId: path.seatingId
          id: path.id
      - text: Show seat {seatId} on 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'