SeatBuilderSeatBuilder Docs
Charts

Get a chart

Returns a single chart by `chartKey`. The response includes both the live `draftVersion` and the `publishedVersion` (or `null` if the chart has never been published).

GET/api/v1/charts/{chartKey}

Path Parameters

chartKeystring

Response Body

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

{
  "chartKey": "chart_8a2b1c",
  "name": "Brooklyn Music Hall — main floor",
  "draftVersion": 3,
  "publishedVersion": 2,
  "createdAt": "2026-09-12T14:22:01.044Z",
  "updatedAt": "2026-09-15T09:11:42.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"
    ]
  }
}

List charts GET

Returns a paginated list of charts in the calling workspace and environment. Use `?page` (1-indexed) and `?limit` (1-100, default 20) to page through results.

Create a chart POST

Creates a draft chart in the calling workspace. Returns the new chart with `chartKey` and `draftVersion`. Drafts are mutable until you call `POST /charts/{chartKey}/publish` — published charts are immutable snapshots that events can bind to.