Get Discord Integration by Unit

Endpoint used to get a Discord integration by unit.

Request Example

curl --request GET \
  --url https://converflow.api.prod.toolzz.media/api/v1/discord/integration/unit/{unitId} \
  --header 'Authorization: Bearer TOKEN_HERE'

Response Example

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

---

Request description

Access Token

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

URL Parameters

Parameter	Type	Description	Required
unitId	String	Unit ID	Yes

Response description

Key	Type	Description
data[]	Array	List of objects containing the integration settings.
data[].id	UUID	Unique identifier of the configuration in the database.
data[].botId	UUID	Identifier of the bot associated with the Toolzz AI platform.
data[].unitId	UUID	Organizational unit identifier.
data[].title	String	Integration identifier name (e.g., “discord”).
data[].isActive	Boolean	Indicates if the integration is enabled.
data[].connectionStatus	String	Real-time connection status (e.g., connected).
data[].guildId	String	Snowflake ID of the Discord server.
data[].guildName	String	Discord server name.
data[].botToken	String	Bot authentication token (masked).
data[].isTokenMasked	Boolean	Confirms if the token is hidden in the response.
data[].permissions	String	Numeric bitwise permission string of the bot.
data[].scope	String	Monitoring scope (e.g., all).
data[].welcomeMessage	String	Configured welcome message.
data[].autoReplyOnMention	Boolean	If the bot automatically responds when mentioned.
data[].threadAutoCreate	Boolean	If the bot automatically creates threads.
data[].channelIds[]	Array[Str]	List of IDs of the actively monitored channels.
data[].channelsDetail[]	Array[Obj]	Mapping of all available channels on the server:
data[].channelsDetail[].id	String	Channel Snowflake ID.
data[].channelsDetail[].name	String	Readable channel name.
data[].lastConnectedAt	String	Timestamp of the last successful connection (ISO 8601).
data[].lastDisconnectedAt	String/Null	Timestamp of the last disconnection.
data[].lastConnectionErrorCode	String/Null	Error code of the last connection attempt.
data[].lastConnectionErrorMessage	String/Null	Error message of the last connection attempt.
data[].createdAt	String	Record creation date.
data[].updatedAt	String	Date of the last data or status update.
data[].deletedAt	String/Null	Logical deletion date (Soft Delete).

---

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