Create Slack Bot
POST /api/v3/organizations/{organisation}/ai/slack-bots
POST
/api/v3/organizations/{organisation}/ai/slack-bots
Creates a new Slack bot backed by an AI agent. The bot must be connected to a Slack workspace via OAuth before it can receive events.
*
* Setup Types:
* - quant: Quant-managed Slack app — uses shared OAuth credentials
* - byo: Bring Your Own — customer provides their own Slack app credentials
Authorizations
Parameters
Path Parameters
organisation
required
string
The organisation ID
Request Body required
object
agentId
required
The AI agent that powers this bot
string
setupType
required
Whether to use Quant-managed or customer-provided Slack app
string
sessionTtlDays
Session TTL in days
integer
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
201
Slack bot created successfully
object
bot
object
400
Invalid request parameters
403
Access denied
500
Failed to create Slack bot