SeatBuilderSeatBuilder Docs
Charts

Update a chart

Patches a chart's draft. Provide `name` and/or `draftVersion` — at least one is required. The update affects the draft only; the published snapshot (if any) is unchanged until you call `/publish`.

PATCH/api/v1/charts/{chartKey}

Path Parameters

chartKeystring

Request Body

name?string

Updated chart name (3-255 chars). Omit to keep the current name.

Length3 <= length <= 255
draftVersion?object

Updated draft snapshot. Replaces the existing draftVersion wholesale; partial merges are not supported. Omit to leave the draft unchanged.

Empty Object

Response Body

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

{
  "chartKey": "chart_8a2b1c",
  "name": "Brooklyn Music Hall — main floor (renamed)",
  "draftVersion": 4,
  "publishedVersion": 2,
  "createdAt": "2026-09-12T14:22:01.044Z",
  "updatedAt": "2026-09-18T11:05:30.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"
    ]
  }
}

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.

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.