stet
API reference

List saved audiences

Saved (kind=saved) audiences only — one-time groups never appear here.

GET/api/audiences

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

Response Body

curl -X GET "https://app.stethq.com/api/audiences"
[
  {
    "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"
}

List API keys

**Dashboard-session only** — this operation does not accept `bk_` Bearer auth (see the `clerkSession` security scheme). Requires capability `apikey:manage` (Admin role). Never returns the secret.

List broadcasts

Newest first. Every field the API key's org can see (workspace-scoped).