API reference
Append a block
Requires `write` (`broadcast:compose`). Draft-only — `409` on any other status.
POST
/api/broadcasts/{id}/blocksAuthorizationBearer <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
typeBlockType
Value in
"section" | "header" | "divider" | "image" | "context" | "actions" | "rich_text_list" | "fields"positioninteger
Range
0 <= valuecontentJsonunknown
Tiptap JSON; structural validation is deferred to the renderer, so this field accepts any value.
audienceIds?array<string>
Default
[]Response Body
curl -X POST "https://app.stethq.com/api/broadcasts/string/blocks" \ -H "Content-Type: application/json" \ -d '{ "type": "section", "position": 0, "contentJson": null }'{
"id": "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"
}