SeatBuilderSeatBuilder Docs
Events

Update an event

Updates an event's `name`. The bound chart cannot be changed here; to give this event its own chart, use `POST /events/{eventKey}/actions/move-to-new-chart-copy`.

PATCH/api/v1/events/{eventKey}

Path Parameters

eventKeystring

Request Body

name?string

Updated event name (≤ 255 chars). Omit to leave the current name unchanged. The bound chart (chartKey) cannot be changed — delete the event and create a new one if you need a different chart.

Lengthlength <= 255

Response Body

curl -X PATCH "https://seatbuilder.org/api/v1/events/string" \  -H "Content-Type: application/json" \  -d '{}'

{
  "eventKey": "evt_q3-2026-jazz-night",
  "chartKey": "chart_8a2b1c",
  "chartPublishedVersion": 3,
  "name": "Friday jazz night — October 2026 (renamed)",
  "createdAt": "2026-09-18T11:30:00.000Z",
  "updatedAt": "2026-09-19T08:42:11.000Z"
}
{
  "statusCode": 0,
  "error": "string",
  "message": "string",
  "code": "validation_failed",
  "failed": [
    {
      "objectLabel": "string",
      "reason": "string",
      "eventKey": "string",
      "environment": "string",
      "booked": 0,
      "held": 0
    }
  ],
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}
{
  "statusCode": 0,
  "error": "string",
  "message": "string",
  "code": "validation_failed",
  "failed": [
    {
      "objectLabel": "string",
      "reason": "string",
      "eventKey": "string",
      "environment": "string",
      "booked": 0,
      "held": 0
    }
  ],
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}
{
  "statusCode": 0,
  "error": "string",
  "message": "string",
  "code": "validation_failed",
  "failed": [
    {
      "objectLabel": "string",
      "reason": "string",
      "eventKey": "string",
      "environment": "string",
      "booked": 0,
      "held": 0
    }
  ],
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}
{
  "statusCode": 0,
  "error": "string",
  "message": "string",
  "code": "validation_failed",
  "failed": [
    {
      "objectLabel": "string",
      "reason": "string",
      "eventKey": "string",
      "environment": "string",
      "booked": 0,
      "held": 0
    }
  ],
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Create an event POST

Creates a new event bound to a published chart. The event starts with all seats in `free` status and has its own independent inventory: events created from the same chart share no seat state and no general-admission capacity (create one event per performance). The bound chart's `publishedVersion` is resolved LIVE at every read — events do not pin a chart version, so republishing the chart updates the layout of every event bound to it (use `move-to-new-chart-copy` to give one event its own chart). Pass your own `eventKey` to make the call safe to retry: a repeat with the same `eventKey` + `chartKey` returns the existing event with `200`.

Delete an event DELETE

Deletes an event that has no held or booked seats, together with its seat history. Refused with `409 event_has_reservations` while any seat is booked or held (expired holds do not count) — release them first. The bound chart is unaffected.

Update an event — SeatBuilder Docs