Skip to content

Create Slack Bot

POST
/api/v3/organizations/{organisation}/ai/slack-bots

Creates a new Slack bot with inline AI agent configuration. A backing agent is created automatically — callers do not need to manage agents separately. * * 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
name
required

Display name for the bot

string
setupType
required

Whether to use Quant-managed or customer-provided Slack app

string
Allowed values: quant byo
systemPrompt
required

System prompt for the backing AI agent

string
modelId
required

AI model identifier

string
temperature

Sampling temperature

number
<= 2
maxTokens

Maximum response tokens

integer
>= 1
allowedTools

Tools the agent may use

Array<string>
assignedSkills

Skills assigned to the agent

Array<string>
allowedCollections

Vector DB collections the agent may query

Array<string>
allowedSubAgents

Sub-agents the agent may call

Array<string>
guardrailPreset

Guardrail preset name

string
filterPolicies

Content filter policies

Array<string>
longContext

Enable long context mode

boolean
sessionTtlDays

Session TTL in days

integer
>= 1 <= 90
allowedChannels

Slack channel IDs the bot may respond in

Array<string>
allowedUsers

Slack user IDs allowed to interact with the bot

Array<string>
deniedUsers

Slack user IDs denied from interacting with the bot

Array<string>
allowGuests

Whether guest users may interact with the bot

boolean
homeTabContent

Content shown on the bot’s Home tab in Slack

string
agentAccessControl

Agent-level access control settings

object
keywordsEnabled

Whether keyword triggers are enabled

boolean
keywords

Keywords that trigger the bot

Array<string>

Responses

201

Slack bot created successfully

object
bot
object

400

Invalid request parameters

403

Access denied

500

Failed to create Slack bot