stet
API reference

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.

PUT/api/broadcasts/{id}/one-time-channels

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

channelIdsarray<string>
Itemsitems <= 1000

Response Body

curl -X PUT "https://app.stethq.com/api/broadcasts/string/one-time-channels" \  -H "Content-Type: application/json" \  -d '{    "channelIds": [      "string"    ]  }'
{
  "audience": {
    "id": "string",
    "name": "One-time channels",
    "color": "a1",
    "channelIds": [
      "string"
    ],
    "kind": "one_time"
  },
  "warnings": [
    {
      "code": "bot_not_in_channel",
      "channelIds": [
        "string"
      ],
      "message": "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"
}

Render the Slack Block Kit preview

Read-only — the exact render the send pipeline would post. Either `aggregate=1` (the union across every targeted audience, annotated with per-block visibility) or `audience_id` (one audience's exact render) is required; `audience_id` must be an audience actually targeted by this broadcast.

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.