stet
API reference

Reorder blocks

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

POST/api/broadcasts/{id}/blocks/reorder

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

blockIdsarray<string>
Items1 <= items

Response Body

curl -X POST "https://app.stethq.com/api/broadcasts/string/blocks/reorder" \  -H "Content-Type: application/json" \  -d '{    "blockIds": [      "string"    ]  }'
Empty
{
  "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 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.

Retry every failed send

Requires `write` (`broadcast:send`). Same direct guarded re-post path as the single-send retry, fanned out with a concurrency cap of 5. `retried: 0` (with `status: null`) when there was nothing to retry.