SeatBuilderSeatBuilder Docs
Charts

Publish a chart

Promotes the current draft to a published version, incrementing `publishedVersion`. New events created from this chart will bind to the new published version. Republishing while events exist updates the live layout that events read at request time (events do not carry a snapshot).

POST/api/v1/charts/{chartKey}/publish

Path Parameters

chartKeystring

Response Body

curl -X POST "http://localhost:3000/api/v1/charts/string/publish"

{
  "chartKey": "chart_8a2b1c",
  "name": "Brooklyn Music Hall — main floor",
  "draftVersion": 4,
  "publishedVersion": 3,
  "publishedAt": "2026-09-18T11:10:00.000Z",
  "updatedAt": "2026-09-18T11:10: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"
    ]
  }
}

Delete a chart DELETE

Deletes a chart. Fails with 409 if the chart has any events bound to it — delete the events first, or duplicate to a new chart and rebind.

Unpublish a chart POST

Clears the `publishedVersion` on a chart. Events already created from previously-published versions keep working (they read the chart's current `publishedVersion` live; if `null`, the chart appears empty). Use with care.