Skip to content

Update Slack Bot

PUT
/api/v3/organizations/{organisation}/ai/slack-bots/{botId}

Updates a Slack bot’s configuration. Only provided fields are updated.

Authorizations

Parameters

Path Parameters

organisation
required
string

The organisation ID

botId
required
string

The Slack bot ID

Request Body required

object
agentId

Change the backing AI agent

string
status

Enable or disable the bot

string
Allowed values: active inactive
sessionTtlDays

Session TTL in days

integer
>= 1 <= 90
allowedChannels

Slack channel IDs the bot may respond in

Array<string>
keywordsEnabled

Whether keyword triggers are enabled

boolean
keywords

Keywords that trigger the bot

Array<string>
slashCommands

Slash commands the bot responds to

Array<string>

Responses

200

Slack bot updated successfully

object
bot
object

400

Invalid request parameters

403

Access denied

404

Slack bot not found

500

Failed to update Slack bot