SeatBuilderSeatBuilder Docs
Events

Create an event

Creates a new event bound to a published chart. The event starts with all seats in `free` status. The bound chart's `publishedVersion` is resolved LIVE at every status read — events do not carry a snapshot.

POST/api/v1/events

Request Body

chartKeystring

Key of the published chart this event binds to (e.g. chart_8a2b1c). The chart MUST have a non-null publishedVersion — call POST /charts/{chartKey}/publish first if it is still in draft.

Length1 <= length
name?string

Optional human-readable event name (≤ 255 chars). Shown in the dashboard events list and on webhook payloads. When omitted the event is identified by its eventKey alone.

Lengthlength <= 255

Response Body

curl -X POST "http://localhost:3000/api/v1/events" \  -H "Content-Type: application/json" \  -d '{    "chartKey": "string"  }'

{
  "eventKey": "evt_q3-2026-jazz-night",
  "chartKey": "chart_8a2b1c",
  "chartPublishedVersion": 3,
  "name": "Friday jazz night, October 2026",
  "createdAt": "2026-09-18T11:30:00.000Z",
  "updatedAt": "2026-09-18T11:30:00.000Z"
}
{
  "statusCode": 0,
  "message": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}
{
  "statusCode": 0,
  "message": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}
{
  "statusCode": 0,
  "message": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}
{
  "statusCode": 0,
  "message": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Get an event GET

Returns a single event by `eventKey`. The `chartPublishedVersion` is resolved LIVE from the bound chart at read time (per Phase 12 INNER JOIN) — if the chart has been unpublished after the event was created, `chartPublishedVersion` will be `null`.

Update an event PATCH

Updates an event's `name`. The bound chart cannot be changed; delete the event and create a new one if you need to rebind.