Skip to content
QuantCDN

Create Slack Bot

POST
/api/v3/organizations/{organisation}/ai/slack-bots
curl --request POST \
  --url https://dashboard.quantcdn.io/api/v3/organizations/example/ai/slack-bots \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "setupType": "quant", "systemPrompt": "example", "modelId": "example", "temperature": 1, "maxTokens": 1, "allowedTools": [ "example" ], "assignedSkills": [ "example" ], "allowedCollections": [ "example" ], "allowedSubAgents": [ "example" ], "guardrailPreset": "example", "filterPolicies": [ "example" ], "longContext": true, "sessionTtlDays": 1, "allowedChannels": [ "example" ], "allowedUsers": [ "example" ], "deniedUsers": [ "example" ], "allowGuests": true, "homeTabContent": "example", "agentAccessControl": {}, "keywordsEnabled": true, "keywords": [ "example" ] }'

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

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
organisation
required
string

The organisation ID

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
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

Section titled “Responses”

201

Section titled “201”

Slack bot created successfully

Media typeapplication/json
object
bot
object
Examplegenerated
{
  "bot": {}
}

400

Section titled “400”

Invalid request parameters

403

Section titled “403”

Access denied

500

Section titled “500”

Failed to create Slack bot