Change how the Slack bot replies: in threads, with sources, and whether unanswered questions become documentation gaps.
PATCH/v1/projects/{projectId}/addons/slack_bot/settingsTry it
Session token
Changes how the project's Slack bot behaves. Send only the settings you want to change; the others keep their values.
Note
Requires the admin or owner role. A member gets 403 forbidden ("Only workspace admins can change Slack bot settings.") with details.requiredRole: "admin". Needs a session JWT — an API key gets 401. Any member can read the settings with Get Slack Bot Status.
Starter plan or higher. Lower plans get 402 plan_required with feature: slack_bot — see Plan errors.
Path Parameters
NameDescription
projectId:stringpathRequired
The project ID.
Request Body
At least one of the following. No other fields are allowed. All three default to true, which is how the bot behaved before these settings existed.
NameDescription
replyInThread:booleanbody
true: answer a message that mentions the bot in a thread under it. false: answer in the channel. A question asked inside an existing thread is always answered in that thread.
showSources:booleanbody
Append the list of docs pages the answer drew on.
flagUnanswered:booleanbody
Record a question the bot answered without any source as a documentation gap.
Response — 200 OK
All three settings after the change:
The bot uses the new settings from its next message. The saved bot token and signing secret are not touched.
Error Responses
400 Bad Request
The body is empty, has a field other than the three settings, or a value that is not a boolean:
json
{
"error": {
"code": "validation_error",
"message": "Send one or more of replyInThread, showSources, flagUnanswered as booleans",