stet
API reference

Replace the entire block list

Requires `write` (`broadcast:compose`). Doc-is-truth bulk reconcile — insert/update/delete/reorder blocks and replace per-block audience visibility in one transaction. Draft-only — `409` on any other status.

PUT/api/broadcasts/{id}/blocks

Authorization

AuthorizationBearer <token>

A Stet API key (prefix bk_), created under Settings → API keys. The whole API requires the Growth plan or higher; keys are scoped read or write — composing and sending require write.

In: header

Path Parameters

idstring

Request Body

blocksarray<ReconcileBlockNode>

Response Body

curl -X PUT "https://app.stethq.com/api/broadcasts/string/blocks" \  -H "Content-Type: application/json" \  -d '{    "blocks": [      {        "type": "section",        "contentJson": null      }    ]  }'
{
  "blocks": [
    {
      "id": "string",
      "position": 0,
      "type": "string",
      "audienceIds": [
        "string"
      ]
    }
  ]
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

Replace the broadcast's one-time channel group

Requires `write` (`broadcast:compose`). The ONLY write surface for a broadcast's ad-hoc one-time channel group — an empty `channelIds` deletes the group. Draft-only — `409` on any other status.

Reorder blocks

Requires `write` (`broadcast:compose`). Unlike the other block writes, this route has no draft-only status guard.