API reference
Invite Stet's bot to channels
Requires `write` (`channel:manage`). Uses `conversations.join` — only works for public channels the bot can self-join. Per-channel errors are captured, not thrown, so a partial batch still reports every outcome.
POST
/api/channels/invite-botAuthorizationBearer <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
channelIdsarray<string>
Deduplicated server-side; must resolve to channels in this workspace.
Response Body
curl -X POST "https://app.stethq.com/api/channels/invite-bot" \ -H "Content-Type: application/json" \ -d '{ "channelIds": [ "string" ] }'{
"results": [
{
"channel": "string",
"ok": true,
"error": "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"
}