API reference
Get a saved audience
404 for a one-time group's id — those aren't addressable through this CRUD surface.
GET
/api/audiences/{id}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
Response Body
curl -X GET "https://app.stethq.com/api/audiences/string"{
"id": "string",
"name": "string",
"description": "string",
"color": "a1",
"channelIds": [
"string"
],
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}{
"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"
}Duplicate a broadcast
Requires `write` (`broadcast:compose`). Clones targeting, blocks, and per-block visibility into a fresh draft titled "Copy of …"; drops the source's one-time channel group. No status guard.
Get a broadcast
Lifecycle fields plus targeted audiences, ordered blocks, and the one-time channel group (if any). Used by the composer.