Update Slack Bot

Endpoint to update a Slack bot in the ToolzzAI agent.

Request Example

curl --request PUT \
  --url https://converflow.api.prod.toolzz.media/api/v1/slack/integration/{integrationId} \
  --header 'Authorization: Bearer TOKEN_HERE' \
  --header 'Content-Type: application/json' \
  --data '
{
  "unitId": "uuid",
  "title": "<string>",
  "replyOnMention": boolean,
  "replyInDms": boolean,
  "threadAutoReply": boolean,
  "channelIds": [
    "<channel_id_string>"
  ]
}
'

Response Example

{
  "id": "uuid",
  "botId": "uuid",
  "unitId": "uuid",
  "teamId": "string",
  "title": "string",
  "botToken": "string",
  "signingSecret": "string",
  "isActive": true,
  "isTokenMasked": true,
  "scope": "string",
  "channelIds": ["string"],
  "channelsDetail": [],
  "defaultChannelId": null,
  "replyOnMention": true,
  "replyInDms": true,
  "threadAutoReply": true,
  "welcomeMessage": "",
  "createdAt": "YYYY-MM-DD HH:mm:ss",
  "updatedAt": "YYYY-MM-DD HH:mm:ss",
  "deletedAt": null
}

Request description

Access Token

Parameter	Type	Description	Required
`Authorization`	String	Access token (“Bearer” must be before the token)	Yes

URL Parameters (Path)

Parameter	Type	Description	Required
`integrationId`	UUID	Unique integration identifier in the database.	Yes

Body Parameters

Key	Type	Description	Required
`unitId`	UUID	Unique identifier of the owning organizational unit.	Yes
`title`	String	Friendly name to identify the configuration (e.g., “Slack Integration”).	Yes
`replyOnMention`	Boolean	If `true`, the AI will respond only when mentioned with `@`.	Yes
`replyInDms`	Boolean	If `true`, the AI is authorized to respond in direct messages (DMs).	Yes
`threadAutoReply`	Boolean	If `true`, the AI will respond automatically within started threads.	Yes
`channelIds`	Array[Str]	List of IDs of the Slack channels where these rules apply.	Yes

Response description

Key	Type	Description
`id`	UUID	Unique identifier of the integration configuration in the database.
`botId`	UUID	Identifier of the Toolzz AI agent that processes the messages.
`unitId`	UUID	Unique identifier of the owning organizational unit.
`teamId`	String	Unique Workspace (Team) ID on Slack.
`title`	String	Friendly name assigned to the integration (e.g., “Slack Integration”).
`botToken`	String	Bot OAuth Token (masked or full depending on `isTokenMasked`).
`signingSecret`	String	Secret key to validate Slack requests (masked/full).
`isActive`	Boolean	Defines if the integration is enabled to respond.
`isTokenMasked`	Boolean	If `true`, indicates that the token fields contain asterisks for security.
`scope`	String	Configured scope of action (e.g., `all`).
`channelIds`	Array[Str]	List of IDs of the Slack channels allowed for the bot.
`channelsDetail`	Array	List with detailed channel metadata (e.g., names, types).
`defaultChannelId`	Null/Str	Main channel ID for proactive communications.
`replyOnMention`	Boolean	If `true`, the bot only responds if mentioned with `@`.
`replyInDms`	Boolean	If `true`, the bot can interact via Direct Messages (private).
`threadAutoReply`	Boolean	If `true`, the bot responds automatically within threads.
`welcomeMessage`	String	Welcome message sent on the first contact.
`createdAt`	String	Integration creation date and time (ISO 8601).
`updatedAt`	String	Date and time of the last data update.
`deletedAt`	Null/Str	Logical deletion date (soft delete), if applicable.

Security

To access this endpoint, it is necessary to send a valid access token through the authorization header (Authorization) of the request. Additionally, the API is protected by other security measures to safeguard user data.

To access your access token, follow these steps:

Log in to the ToolzzAI platform
Click on “Settings”
Click on “Access Token”
Copy the access token

Access token page