Cvent Event Cloud Seating API

openapi: 3.2.0
info:
  title: Cvent REST APIs — Event Cloud Seating API
  description: "Event Cloud scope of the Cvent REST APIs. This document is a TAG-SCOPED SUBSET of the OpenAPI specification Cvent publishes at https://github.com/cvent/rest-sdks/blob/main/cvent-public-spec/openapi.yaml (the source of truth for Cvent's official TypeScript/.NET/Java SDKs). Venue-sourcing, RFP, housing-supplier and travel-supplier tags were removed because they belong to Cvent Hospitality Cloud; every path, operation, parameter, schema and security requirement below is verbatim from Cvent's published spec.\n\n# Introduction\nThe Cvent API Platform is built around REST. We aim to provide intuitive endpoints that can be easily\ndiscovered to help leverage the Cvent platform for your event needs. The RESTful APIs outlined here\nuse JSON-encoded request and response format, along with HTTP codes, to convey processing status of\nrequests received. The Cvent resources are protected using OAuth2.\n\n# Getting Started\n\nIf you're new to the Cvent API Platform, start by reading our\n[Developer Quickstart](https://developers.cvent.com/docs/rest-api/tutorials/developer-quickstart) guide. This will\ngive you an overview of how to authenticate and make requests using our APIs.\n\n## Authentication\n\nThe Cvent REST API uses [OAuth2](https://oauth.net/2/) to authorize requests to the platform. The client\ncredentials authorization flow is supported.\n\n<a name=\"oauth2-auth-code-planner-admin\"></a>\n\nAuthorization code flow is only supported for planner users with the administrator role in Cvent. Developer users\ncannot use authorization code flow.\n\n<!-- ReDoc-Inject: <security-definitions> -->\n\nHere's an example of using client credential flow to authorize. You'll supply your application's id and secret to\nmake a [Token](#operation/oauth2Token) request.\n\n```bash\ncurl --location --request POST '{hostName}/{version}/oauth2/token' \\\n--header 'Content-Type: application/x-www-form-urlencoded' \\\n--header 'Authorization: Basic {api_credentials}' \\\n--data-urlencode 'grant_type=client_credentials' \\\n--data-urlencode 'client_id={client_id}'\n```\n\n| Key               | Description                                          | Value                                                                                                        |\n| :---------------- | :--------------------------------------------------- | :----------------------------------------------------------------------------------------------------------- |\n| {hostName}        | https://api-platform.cvent.com                       | Location if your account is in the North American datacenter.                                                |\n|                   | https://api-platform-eur.cvent.com                   | Location if your account is in the European data center.                                                     |\n| {version}         | ea                                                   | The version of the API you're using. Only `ea` is currently supported.                                       |\n| {api_credentials} | {client_id}:{client_secret} in base64 encoded format | Supply your client id & client credentials in a base 64 encoded format.                                      |\n| {client_id}       | Retrieved from your application                      | Your application's client id.                                                                                |\n| {client_secret}   | Retrieved from your application                      | Your application's client secret.                                                                            |\n\nOn a successful call, you'll receive the following response:\n\n```json\n{\n  \"access_token\": \"{accessToken}\",\n  \"expires_in\": 3600,\n  \"token_type\": \"Bearer\"\n}\n```\n\nThis bearer token is valid for 3600 seconds (60 minutes) and must be used in subsequent calls.\n\n## Endpoints\n\nEndpoints start with `hostName` and `version`.\n\nThe `hostname` will depend on the region that your Cvent account is hosted in. Please see the table\nbelow to identify which hostname you should be using.\n\n| Region        |\tHostname                           |\n|:--------------|:-----------------------------------|\n| North America\t| https://api-platform.cvent.com     |\n| Europe        | https://api-platform-eur.cvent.com |\n\nThe current `version` of the Cvent API is `ea`.\n\n## Rate Limits\n\nCvent APIs enforce rate limits to ensure platform stability. Your limits depend on your tier: Free,\nStandard, or Premium.\n\n<br />\n\n### Usage Tiers\n\n| Tier     | Daily Calls | Calls per Second | Max Burst |\n| -------- | ----------- | ---------------- | --------- |\n| Free     | 1,000       | 2                | 1         |\n| Standard | 15,000      | 10               | 10        |\n| Premium  | 500,000     | 25               | 25        |\n\n- **Daily calls** define how many requests you can make in a 24-hour period. Quota\n  resets at 12 midnight (+0 GMT).\n- **Calls per second** define how many requests you can make in a 1-second window.\n- **Max Burst** defines how many requests you can make at once.\n\nIf you are unsure what usage tier applies to your account, you can check via\n[Get Current Usage Tier](#operation/getUsageTier).\n\nPlease note that these limits may change as the Cvent API Platform evolves.\n\n<br />\n\n### Handling Rate Limits\n\nSometimes, you may exceed your rate limits. When this happens, the API will return a `429 Too Many Requests`. See\n[handling rate limits](https://developers.cvent.com/docs/rest-api/guides/handling-rate-limits) for best practices on how to handle this.\n\n## Pagination\n\nSome APIs use pagination to manage records. Each page of records has a token associated to identify it.\n\nIf an API uses pagination, you’ll find up to three tokens in the response:\n- **currentToken**: Describes the token of the current page.\n- **nextToken**: Provides a token for the next page of records, if one exists.\n- **previousToken**: Provides a token for the previous page of records, if one exists. Not all APIs will return\n  this token.\n\nYou specify which page of records to view via the `token` parameter in your API call. To navigate through pages,\ntake the `nextToken` or `previousToken` value and pass it to your next call’s `token` parameter to get the\nrespective page of records. For example, if you made this request:\n\n```bash\ncurl -X GET {hostname}/{version}/contacts?limit=100 \\\n-H 'Accept: application/json' \\\n-H 'Authorization: Bearer {accessToken}'\n```\n\nThe response contains a paging array where you'll find the token information.\n\n```json\n{\n  \"paging\": {\n    \"currentToken\": \"90c5f062-76ad-4ea4-aa53-00eb698d9262\",\n    \"nextToken\": \"3b2359a7-4583-40ed-8afd-67e5f15373d3\",\n    \"limit\": 100,\n    \"totalCount\": 102,\n    \"_links\": {...}\n  },\n  \"data\": [...]\n}\n```\n\nTake the `nextToken` and use it in the `token` parameter on your subsequent call.\n\n```bash\ncurl -X GET {hostname}/{version}/contacts?limit=100&token=3b2359a7-4583-40ed-8afd-67e5f15373d3 \\\n-H 'Accept: application/json' \\\n-H 'Authorization: Bearer {accessToken}'\n```\n\nWhen the response doesn’t contain a `nextToken` field, you’ve reached the last page. Occasionally, you might\nencounter an empty page at the end of results. This typically happens when the results were evenly divisible.\nEnsure your client code handles the possibility of receiving an empty data array when using the `nextToken`.\n\n## Filtering\n\nUse filters to narrow down results. The filter follows the pattern\n`filter='field' comparisonType 'value'`. The value can be enclosed with single\nquotes (') or double quotes (\").\n\n```bash\nGET {hostName}/{version}/contacts?filter=lastName eq 'Smith'\n````\n\nTo correctly pass a single quote in the filter's value, use double quotes around\nthe string.\n\n```bash\nGET {hostName}/{version}/contacts?filter=lastName eq \"O'Keenan\"\n```\n\nTo correctly pass a double quote in the filter's value, use double quotes around\nthe string and add an escape character `\\` to each quote that is part of the\nstring.\n\n```bash\nGET {hostName}/{version}/events?filter=eventName eq \"\\\"Yearly\\\" Conference\"\n```\n\n## Versioning\n\nChange is inevitable in API development. Planning for it is crucial. We track\nboth backward-compatible and backward-incompatible changes.\n\n<br />\n\n### Backward Compatible Changes\n\nBackward compatible changes will be made often and are intended to avoid\nany adverse impact on our customers. It is highly advisable that when reading\nJSON payloads from Cvent, you are able to handle \"unknown\" attributes that\ncan be added over time. We consider the following changes backward-compatible:\n\n- Adding new resources\n- Adding new optional request parameters to existing operations\n- Adding new attributes to requests or responses\n- Changing the length or format (not type) of resource identifiers. For example, an ID can change from\n  \"1234/1234\" to \"1234::1234\".\n- Increasing the length of string fields\n\n<br />\n\n### Backward Incompatible Changes\n\nBackward-incompatible changes are made infrequently, however, they can be\ndisruptive to consumers. Due to this, our APIs are versioned to avoid\ndisruptions to customers. We leverage a URI-based versioning scheme,\nwhich means that a version value is included in the Cvent API URL.\nWhen breaking changes occur, a new version of the API is made available\nwhile the existing version is deprecated but remains available for a\nlimited period of time. We consider the following backward-incompatible changes:\n\n- Adding a new required parameter (query string param or payload attribute)\n- Deleting API resources\n- Deleting any attribute from API responses\n- Changing the data type on any parameter or attribute\n\n## Standards\nAs you begin working with our APIs, it's essential to be aware of standards around\ncountry codes, time formats, and other important details that ensure smooth integration.\nLearn more about our [API Standards](https://developers.cvent.com/docs/rest-api/reference/api-standards)\n"
  contact:
    name: Cvent Development Platform
    url: https://developers.cvent.com/
  version: ea
servers:
- url: https://api-platform.cvent.com/ea
- url: https://api-platform-eur.cvent.com/ea
tags:
- name: Seating
  description: 'Seating lets you plan seating at your events by configuring tables and assigning seats to your attendees. The seating APIs allow you to create, update, and delete seating, tables, seats, and seating assignments.

    * **Seating** - A diagram of tables and seats. Your event can have many seatings.

    * **Table** - A communal location where chairs are assigned. Each table is assigned to a seating.

    * **Seat** - Individual seat at a table. Each seat can be assigned to an attendee.

    * **Assignments** - Seat that is assigned to an attendee.'
paths:
  /events/{id}/seatings:
    parameters:
    - $ref: '#/components/parameters/eventId4'
    get:
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/token'
      - name: filter
        in: query
        required: false
        description: "A filter string passed in the body of the request, narrows search results and supports the combination of logical and comparison operators.\nThe filter adheres to the pattern filter='field' comparisonType 'value'.\n\nThere are eight comparison types that can be used in filter expressions:\n  * equal: eq\n  * not equal: ne\n  * greater than: gt\n  * greater or equal: ge\n  * less than: lt\n  * less than or equal: le\n  * starts with: sw\n  * contains a value: contains\n  * includes value(s): in\n\nThe following fields are filterable:\n  * id (eq)\n\nThe following operators are available:\n  * and\n  * or\n"
        schema:
          type: string
          example: id eq 'ad6df5aa-f21f-47e6-9c48-8d3a7831ad5f'
      security:
      - OAuth2.clientCredentials:
        - seating/event-seatings:read
      - OAuth2.authorizationCode:
        - seating/event-seatings:read
      summary: List Seating
      description: Get seating details for the given event.
      operationId: listSeating
      tags:
      - Seating
      responses:
        '200':
          description: Successfully retrieved a paginated list of seatings for the event.
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/seating-paginated-response'
        '400':
          $ref: '#/components/responses/BadRequest1'
        '401':
          $ref: '#/components/responses/Unauthorized1'
        '403':
          $ref: '#/components/responses/Forbidden1'
        '404':
          $ref: '#/components/responses/NotFound1'
        '429':
          $ref: '#/components/responses/TooManyRequests1'
      externalDocs:
        description: More about OAuth2 authorization code support for administrators
        url: '#oauth2-auth-code-planner-admin'
  /events/{id}/seatings/assignments:
    parameters:
    - $ref: '#/components/parameters/eventId4'
    get:
      summary: List All Seating Assignments
      description: Gets all the table assignments across all the seatings in an event.
      operationId: getEventTableAssignments
      tags:
      - Seating
      security:
      - OAuth2.clientCredentials:
        - seating/assignments:read
      - OAuth2.authorizationCode:
        - seating/assignments:read
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/token'
      - $ref: '#/components/parameters/seatingAssignmentsFilter'
      - $ref: '#/components/parameters/seatingAssignmentExpand'
      responses:
        '200':
          description: Successfully retrieved a paginated list of table assignments for the given event.
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/table-assignment-paginated-response'
        '400':
          $ref: '#/components/responses/BadRequest1'
        '401':
          $ref: '#/components/responses/Unauthorized1'
        '403':
          $ref: '#/components/responses/Forbidden1'
        '404':
          $ref: '#/components/responses/NotFound1'
        '429':
          $ref: '#/components/responses/TooManyRequests1'
      externalDocs:
        description: More about OAuth2 authorization code support for administrators
        url: '#oauth2-auth-code-planner-admin'
  /events/{id}/seatings/{seatingId}:
    parameters:
    - $ref: '#/components/parameters/eventId4'
    - $ref: '#/components/parameters/seatingId'
    get:
      security:
      - OAuth2.clientCredentials:
        - seating/event-seatings:read
      - OAuth2.authorizationCode:
        - seating/event-seatings:read
      summary: Get Seating
      description: Get seating details for the given event by seating ID.
      operationId: getSeating
      tags:
      - Seating
      responses:
        '200':
          description: Successfully retrieved seating info for given seating ID.
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/existing-seating'
        '401':
          $ref: '#/components/responses/Unauthorized1'
        '403':
          $ref: '#/components/responses/Forbidden1'
        '404':
          $ref: '#/components/responses/NotFound1'
        '429':
          $ref: '#/components/responses/TooManyRequests1'
      externalDocs:
        description: More about OAuth2 authorization code support for administrators
        url: '#oauth2-auth-code-planner-admin'
  /events/{id}/seatings/{seatingId}/assignments:
    parameters:
    - $ref: '#/components/parameters/eventId4'
    - $ref: '#/components/parameters/seatingId'
    get:
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/token'
      - $ref: '#/components/parameters/seatingAssignmentsFilter'
      - $ref: '#/components/parameters/seatingAssignmentExpand'
      security:
      - OAuth2.clientCredentials:
        - seating/assignments:read
      - OAuth2.authorizationCode:
        - seating/assignments:read
      summary: List Seating Assignments
      description: Gets the table assignments for a given seating ID in an event.
      operationId: getTableAssignment
      tags:
      - Seating
      responses:
        '200':
          description: Successfully retrieved a paginated list of seat information for the given seating ID in an event.
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/table-assignment-paginated-response'
        '400':
          $ref: '#/components/responses/BadRequest1'
        '401':
          $ref: '#/components/responses/Unauthorized1'
        '403':
          $ref: '#/components/responses/Forbidden1'
        '404':
          $ref: '#/components/responses/NotFound1'
        '429':
          $ref: '#/components/responses/TooManyRequests1'
      externalDocs:
        description: More about OAuth2 authorization code support for administrators
        url: '#oauth2-auth-code-planner-admin'
  /events/{id}/seatings/{seatingId}/tables:
    parameters:
    - $ref: '#/components/parameters/eventId4'
    - $ref: '#/components/parameters/seatingId'
    get:
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/token'
      - name: filter
        in: query
        required: false
        description: "A filter string passed in the body of the request, narrows search results and supports the combination of logical and comparison operators.\nThe filter adheres to the pattern filter='field' comparisonType 'value'.\n\nThere are eight comparison types that can be used in filter expressions:\n  * equal: eq\n  * not equal: ne\n  * greater than: gt\n  * greater or equal: ge\n  * less than: lt\n  * less than or equal: le\n  * starts with: sw\n  * contains a value: contains\n  * includes value(s): in\n\nThe following fields are filterable:\n  * id (eq)\n\nThe following operators are available:\n  * and\n  * or\n"
        schema:
          type: string
          example: id eq 'ad6df5aa-f21f-47e6-9c48-8d3a7831ad5f'
      - $ref: '#/components/parameters/tableExpand'
      security:
      - OAuth2.clientCredentials:
        - seating/tables:read
      - OAuth2.authorizationCode:
        - seating/tables:read
      summary: List Tables
      description: Get table details for a given seating.
      operationId: listTables
      tags:
      - Seating
      responses:
        '200':
          description: Successfully retrieved a paginated list of tables.
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/tables-paginated-response'
        '400':
          $ref: '#/components/responses/BadRequest1'
        '401':
          $ref: '#/components/responses/Unauthorized1'
        '403':
          $ref: '#/components/responses/Forbidden1'
        '404':
          $ref: '#/components/responses/NotFound1'
        '429':
          $ref: '#/components/responses/TooManyRequests1'
      externalDocs:
        description: More about OAuth2 authorization code support for administrators
        url: '#oauth2-auth-code-planner-admin'
  /events/{id}/seatings/{seatingId}/tables/{tableId}:
    parameters:
    - $ref: '#/components/parameters/eventId4'
    - $ref: '#/components/parameters/seatingId'
    - $ref: '#/components/parameters/tableId'
    get:
      parameters:
      - $ref: '#/components/parameters/tableExpand'
      security:
      - OAuth2.clientCredentials:
        - seating/tables:read
      - OAuth2.authorizationCode:
        - seating/tables:read
      summary: Get Table
      description: Get table info for given event by seating ID and table ID.
      operationId: getTable
      tags:
      - Seating
      responses:
        '200':
          description: Successfully retrieved table info for the given seating ID and table ID.
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/existing-table-with-seats'
        '400':
          $ref: '#/components/responses/BadRequest1'
        '401':
          $ref: '#/components/responses/Unauthorized1'
        '403':
          $ref: '#/components/responses/Forbidden1'
        '404':
          $ref: '#/components/responses/NotFound1'
        '429':
          $ref: '#/components/responses/TooManyRequests1'
      externalDocs:
        description: More about OAuth2 authorization code support for administrators
        url: '#oauth2-auth-code-planner-admin'
  /events/{id}/seatings/{seatingId}/tables/{tableId}/seats:
    parameters:
    - $ref: '#/components/parameters/eventId4'
    - $ref: '#/components/parameters/seatingId'
    - $ref: '#/components/parameters/tableId'
    get:
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/token'
      - name: filter
        in: query
        required: false
        description: "A filter string passed in the body of the request, narrows search results and supports the combination of logical and comparison operators.\nThe filter adheres to the pattern filter='field' comparisonType 'value'.\n\nThere are eight comparison types that can be used in filter expressions:\n  * equal: eq\n  * not equal: ne\n  * greater than: gt\n  * greater or equal: ge\n  * less than: lt\n  * less than or equal: le\n  * starts with: sw\n  * contains a value: contains\n  * includes value(s): in\n\nThe following fields are filterable:\n  * id (eq)\n\nThe following operators are available:\n  * and\n  * or\n"
        schema:
          type: string
          example: id eq 'ad6df5aa-f21f-47e6-9c48-8d3a7831ad5f'
      security:
      - OAuth2.clientCredentials:
        - seating/seats:read
      - OAuth2.authorizationCode:
        - seating/seats:read
      summary: List Seats
      description: Get seat details for given table ID.
      operationId: listSeats
      tags:
      - Seating
      responses:
        '200':
          description: Successfully retrieved a paginated list of seats.
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/seats-paginated-response'
        '400':
          $ref: '#/components/responses/BadRequest1'
        '401':
          $ref: '#/components/responses/Unauthorized1'
        '403':
          $ref: '#/components/responses/Forbidden1'
        '404':
          $ref: '#/components/responses/NotFound1'
        '429':
          $ref: '#/components/responses/TooManyRequests1'
      externalDocs:
        description: More about OAuth2 authorization code support for administrators
        url: '#oauth2-auth-code-planner-admin'
  /events/{id}/seatings/{seatingId}/tables/{tableId}/seats/{seatId}:
    parameters:
    - $ref: '#/components/parameters/eventId4'
    - $ref: '#/components/parameters/seatingId'
    - $ref: '#/components/parameters/tableId'
    - $ref: '#/components/parameters/seatId'
    get:
      security:
      - OAuth2.clientCredentials:
        - seating/seats:read
      - OAuth2.authorizationCode:
        - seating/seats:read
      summary: Get Seat
      description: Get seat info for given event by seating ID, table ID, and seat ID.
      operationId: getSeat
      tags:
      - Seating
      responses:
        '200':
          description: Successfully retrieved seat info for the given seat ID.
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/existing-seat'
        '401':
          $ref: '#/components/responses/Unauthorized1'
        '403':
          $ref: '#/components/responses/Forbidden1'
        '404':
          $ref: '#/components/responses/NotFound1'
        '429':
          $ref: '#/components/responses/TooManyRequests1'
      externalDocs:
        description: More about OAuth2 authorization code support for administrators
        url: '#oauth2-auth-code-planner-admin'
components:
  schemas:
    seats-paginated-response:
      title: SeatsPaginatedResponse
      description: The response from a request to get the event seat for the event.
      required:
      - data
      type: object
      properties:
        paging:
          $ref: '#/components/schemas/paging.json'
        data:
          type: array
          items:
            $ref: '#/components/schemas/existing-seat'
          description: A list of event seats
    uuid-property:
      title: UUID Property
      description: A string that has to be a format matching the industry standard uuid
      type: string
      format: uuid
      example: 04ca6ae2-0dc3-487b-953e-86d6abbdf7d3
    table-assignment.json:
      title: TableAssignment
      description: The assignment of an attendee to a seat on a table for a given event seating
      type: object
      properties:
        seating:
          $ref: '#/components/schemas/expandable-seating.json'
        table:
          $ref: '#/components/schemas/expandable-table.json'
        seat:
          $ref: '#/components/schemas/expandable-seat.json'
        attendee:
          description: The attendee object.
          type: object
          properties:
            id:
              type: string
              format: uuid
              description: The unique ID of the attendee assigned.
              example: bdcb1fba-0fb3-46d2-b4e7-47ace9bc7907
    paging.json:
      title: Paging
      required:
      - _links
      type: object
      description: Represents pagination information for a collection of resources.
      properties:
        previousToken:
          type: string
          description: The pagination token for the previous page, if one exists. You can use this token to navigate to the previous page of data.
          example: 1a2b3c4d5e6f7g8h9i10j11k
        nextToken:
          type: string
          description: The pagination token for the next page. If this value is present in the response, there is another page of data you can fetch.
          example: 1a2b3c4d5e6f7g8h9i10j11k
        currentToken:
          type: string
          description: The pagination token for the current page.
          example: 1a2b3c4d5e6f7g8h9i10j11k
        limit:
          type: integer
          description: The number of records to return on the page. Not to exceed 200.
          example: 100
        totalCount:
          type: integer
          description: The total number of records available. This field may return blank, even if there are more records. To confirm if there are more records, check the `nextToken` field.
          example: 2
        _links:
          $ref: '#/components/schemas/pagination-links.json'
    link.json:
      title: Link
      required:
      - href
      type: object
      description: Represents a link to a related resource.
      properties:
        href:
          type: string
          description: A url provided that can be followed for linking
          example: ?token=90c5f062-76ad-4ea4-aa53-00eb698d9262
    expandable-table.json:
      title: ExpandableTable
      description: 'An object that contains the associated table ID.


        This is an **expandable** object and if requested will contain all the properties of a table object.'
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: The unique ID of the table.
          example: c9763ce5-b965-44ed-9c2b-b5657dfab012
    ErrorResponseBase:
      title: ErrorResponseBase
      type: object
      description: Represents an error response with no additional details.
      required:
      - code
      - message
      properties:
        code:
          type: integer
          description: The HTTP status code representing the error.
          example: 400
        message:
          type: string
          description: A brief description of the error.
          example: Bad Request
        target:
          type: string
          description: The target resource of the error.
          example: example target
    ErrorResponse:
      title: ErrorResponse
      description: Represents an error response with additional details of cascading error messages.
      allOf:
      - $ref: '#/components/schemas/ErrorResponseBase'
      type: object
      required:
      - code
      - message
      properties:
        details:
          type: array
          items:
            $ref: '#/components/schemas/ErrorResponseBase'
          description: Additional details of cascading error messages.
    existing-seat:
      title: ExistingSeat
      description: The response from a request to get the event seat for the event.
      type: object
      allOf:
      - title: EventSeat
        description: Seat creation for the table.
        type: object
        required:
        - name
        properties:
          name:
            type: string
            description: Seat's plain name.
            example: Management seat
          sourceId:
            description: This is a ID for the seat in an external system. Use this field to supply your own ID for tracking purposes.
            type: string
            maxLength: 50
            example: Id5874
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
          description: The unique ID of the seat.
          example: 37ace026-f4ac-40e3-9144-e2c8399844be
    existing-table:
      title: ExistingTable
      description: The response from a request to get the event table for the event.
      type: object
      allOf:
      - title: EventTable
        description: Create, update and delete table for the specific event.
        type: object
        required:
        - capacity
        properties:
          name:
            type: string
            description: Table's plain name.
            example: CVENT table
          code:
            type: string
            description: Table's code set by the planner.
            example: CAETABLE1
          capacity:
            type: integer
            description: Table's seat capacity.
            example: 10
          description:
            type: string
            description: Description assigned to table.
            example: This table is for VIP attendees.
          sourceId:
            description: This is a ID for the table in an external system. Use this field to supply your own ID for tracking purposes.
            type: string
            maxLength: 50
            example: Id1255
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
          description: The unique ID of the table.
          example: c9763ce5-b965-44ed-9c2b-b5657dfab012
    tables-paginated-response:
      title: TablesPaginatedResponse
      description: The response from a request to get the event table for the event.
      required:
      - data
      type: object
      properties:
        paging:
          $ref: '#/components/schemas/paging.json'
        data:
          type: array
          items:
            $ref: '#/components/schemas/existing-table-with-seats'
          description: A list of event tables
    expandable-seating.json:
      title: ExpandableSeating
      description: 'An object that contains the associated seating ID.


        This is an **expandable** object and if requested will contain all the properties of a seating object.'
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: The unique ID of the seating.
          example: ad6df5aa-f21f-47e6-9c48-8d3a7831ad5f
    existing-table-with-seats:
      title: ExistingTable
      description: The response from a request to get the event table for the event.
      type: object
      allOf:
      - title: ExistingTable
        description: The response from a request to get the event table for the event.
        type: object
        allOf:
        - $ref: '#/components/schemas/existing-table/allOf/0'
        properties:
          id:
            type: string
            format: uuid
            readOnly: true
            description: The unique ID of the table.
            example: c9763ce5-b965-44ed-9c2b-b5657dfab012
      properties:
        seats:
          type: array
          description: 'The seat IDs at the table.


            This

# --- truncated at 32 KB (78 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cvent-event-cloud/refs/heads/main/openapi/cvent-event-cloud-seating-api-openapi.yml