Suggest audiences from channel-name prefixes
Requires `write` (`audience:manage`). Pure heuristic, no LLM: groups channels by a shared `prefix-` in their name (≥3 channels) and proposes a name like "All Marketing", derived from the shared channel-name prefix. Nothing is created — the caller follows up with `POST /api/audiences` to accept a suggestion.
/api/audiences/suggestA 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
Response Body
curl -X POST "https://app.stethq.com/api/audiences/suggest"[
{
"name": "string",
"channelIds": [
"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"
}Set content from Markdown
Requires `write` (`broadcast:compose`). Converts Markdown to blocks and reconciles them via the same doc-is-truth path as `PUT .../blocks`. Draft-only — `409` on any other status. A construct the converter can't represent (images, raw HTML, tables, nested list blocks) 400s with `UnsupportedMarkdownProblem` instead of silently dropping content.
Re-sync channels from Slack
Requires `write` (`channel:manage`). Refreshes channel metadata (including bot membership) without disconnecting Slack. Detects a Slack-side auth revocation and soft-disconnects the workspace (`409 connection-disconnected`) if the token is dead.