stet
API reference

Update a sending profile

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

PATCH/api/sending-profiles/{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
displayName?string
Length1 <= length <= 100
description?string | null
Lengthlength <= 500
avatarUrl?string | null
Formaturi
footerText?string | null
Lengthlength <= 500
defaultAudienceIds?array<string>
Itemsitems <= 100

Response Body

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

Update a broadcast's title, sending profile, or saved-audience targeting

Requires `write` (`broadcast:compose`). `audienceIds`, when present, replaces the SAVED-audience set only — the one-time channel group (if any) is always preserved. No status guard: callable regardless of the broadcast's current status.

Upload a sending-profile avatar image

Requires `write` (`sending_profile:manage`). NOTE: this endpoint takes no `{id}` — it is a standalone upload that returns a URL; pass that URL as `avatarUrl` on a create/update call to attach it to a profile. PNG, JPEG, WebP, or GIF; max 2MB.