Update Discord Bot Integration

Endpoint to update a Discord bot in the ToolzzAI agent.

Request Example

curl --request PUT \
  --url https://chat.api.toolzz.com.br/api/v1/discord/integration/{integrationId} \
  --header 'Authorization: Bearer TOKEN_HERE' \
  --header 'Content-Type: application/json' \
  --data '
{
  "botId": "uuid",
  "unitId": "uuid",
  "title": "string",
  "guildId": "string_digits",
  "guildName": "string",
  "channelIds": [
    "string_digits"
  ],
  "channelsDetail": [
    {
      "id": "string_digits",
      "name": "string"
    }
  ],
  "permissions": "string_digits",
  "autoReplyOnMention": true,
  "threadAutoCreate": true,
  "scope": "all | mentions | none"
}
'

Response Example

{
  "id": "uuid",
  "botId": "uuid",
  "unitId": "uuid",
  "title": "string",
  "isActive": true,
  "connectionStatus": "string",
  "guildId": "string_digits",
  "guildName": "string",
  "botToken": "string",
  "isTokenMasked": true,
  "permissions": "string_digits",
  "scope": "string",
  "welcomeMessage": "string",
  "autoReplyOnMention": true,
  "threadAutoCreate": true,
  "channelIds": [
    "string_digits"
  ],
  "channelsDetail": [
    {
      "id": "string_digits",
      "name": "string"
    }
  ],
  "lastConnectedAt": "string",
  "lastDisconnectedAt": null,
  "lastConnectionErrorCode": null,
  "lastConnectionErrorMessage": null,
  "createdAt": "2026-04-17 12:26:12.804444",
  "updatedAt": "2026-04-17 12:42:02.807",
  "deletedAt": null
}

Request description

Access Token

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

URL Parameter

Parameter	Type	Description	Required
integrationId	String	Discord integration ID	Yes

Body Parameters

Parameter	Type	Description	Required
botId	UUID	Unique bot identifier in the Toolzz AI system.	Yes
unitId	UUID	Unique identifier of the owning organizational unit.	Yes
title	String	Integration identifier name (e.g., “Discord Support”).	Yes
guildId	String	Discord server Snowflake ID.	Yes
guildName	String	Discord server name.	Yes
channelIds	Array[Str]	List of channel IDs that the bot should actively monitor.	Yes
permissions	String	Numeric permission string (Bitwise) of the bot.	Yes
autoReplyOnMention	Boolean	If true, the bot will automatically respond when mentioned.	Yes
threadAutoCreate	Boolean	If true, the bot will manage conversations through threads.	Yes
scope	String	Bot reading scope (all, mentions, or none).	Yes
channelsDetail[]	Array[Obj]	List of objects with basic channel information:	Yes
channelsDetail[].id	String	Channel Snowflake ID.	Yes
channelsDetail[].name	String	Channel name (e.g., “general”).	Yes

---

Response description

Key	Type	Description
id	UUID	Unique identifier of the integration configuration in the database.
botId	UUID	Bot identifier associated within the Toolzz AI platform.
unitId	UUID	Unique identifier of the organizational unit owning this configuration.
title	String	Integration identifier name or label (e.g., “discord”).
isActive	Boolean	Defines if the integration is enabled (true) or paused (false).
connectionStatus	String	Real-time status of the connection with the Discord API (e.g., connected).
guildId	String	Snowflake ID (numeric) of the Discord server.
guildName	String	Server name as registered on Discord.
botToken	String	Bot authentication token (displayed in a masked form).
isTokenMasked	Boolean	Signals if the returned token is hidden for security reasons.
permissions	String	Numeric string representing the Bitwise permissions of the bot on the server.
scope	String	Defines the scope of the bot’s reading (e.g., all, mentions).
welcomeMessage	String	Custom message sent by the bot when starting a new interaction.
autoReplyOnMention	Boolean	If active, the bot generates automatic responses when mentioned with @.
threadAutoCreate	Boolean	If active, the bot organizes conversations by automatically creating threads.
channelIds[]	Array[Str]	List of IDs of the channels selected for active monitoring.
channelsDetail[]	Array[Obj]	List of objects with mapping of all server channels:
channelsDetail[].id	String	Channel ID.
channelsDetail[].name	String	Readable channel name (e.g., “general”, ”🔐”).
lastConnectedAt	String	Date and time of the most recent established connection (ISO 8601).
lastDisconnectedAt	String/Null	Date and time of the last time the bot was disconnected.
lastConnectionErrorCode	String/Null	Technical error code in case of connection attempt failure.
lastConnectionErrorMessage	String/Null	Detailed description of the error generated in the last connection attempt.
createdAt	String	Original record creation date and time.
updatedAt	String	Date and time of the last modification in the fields or status.
deletedAt	String/Null	Logical deletion date (Soft Delete), if the record was removed.

---

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:

1. Log in to the ToolzzAI platform
2. Click on “Settings”
3. Click on “Access Token”
4. Copy the access token