Search Servers

Endpoint used to get Discord servers (guilds).

Request Example

curl --request POST \
  --url https://chat.api.toolzz.com.br/api/v1/discord/guilds \
  --header 'Authorization: Bearer TOKEN_HERE' \
  --header 'Content-Type: application/json' \
  --data '{
    "botToken": "<discord bot token>"
  }'

Response Example

{
  "data": [
    {
      "id": "string",
      "name": "string",
      "icon": "string",
      "banner": null,
      "owner": false,
      "permissions": "string",
      "features": []
    }
  ]
}

---

Request description

Access Token

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

Body Parameters

Parameter	Type	Description	Required
botToken	String	Secret token (Bot Token) obtained from the Discord Developer Portal.	Yes

Response description

Key	Type	Description
data[]	Array	List of objects containing the linked servers (Guilds).
id	String	Numeric ID of the server on Discord.
name	String	Server name as configured on Discord.
icon	String	Hash identifier of the server icon (used to compose the image URL).
banner	String/Null	Hash identifier of the server banner image.
owner	Boolean	Indicates if the authenticated user is the owner (Owner) of the server.
permissions	String	Numeric string representing the total permissions of the user/bot on the server.
features[]	Array	List of special features active on the server (e.g., “COMMUNITY”, “VANITY_URL”).

---

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