stet
API reference

Update a saved audience

Requires `write` (`audience:manage`). At least one field must be present.

PATCH/api/audiences/{id}

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

name?string
Length1 <= length <= 100
description?string
Lengthlength <= 500
channelIds?array<string>
Items1 <= items <= 1000
color?AudienceColor
Value in"a1" | "a2" | "a3" | "a4" | "a5" | "a6"

Response Body

curl -X PATCH "https://app.stethq.com/api/audiences/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "string",
  "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"
}

Send a throwaway test render

Requires `write` (`broadcast:send`). Posts to the caller's own Slack DM or a chosen channel using the exact same render path as a real send — "what you test is what lands" — then a small "this is a test" marker as a follow-up message. Mutates nothing: no broadcast row, no `sends` rows, no idempotency.

Update one block

Requires `write` (`broadcast:compose`). Draft-only — `409` on any other status.