List Toolzz Bots

Endpoint used to list all Toolzz Bots in a workspace.

Request Example

curl --request GET \
  --url 'https://bots.toolzz.ai/api/v1/toolzz?workspaceId={workspaceId}' \
  --header 'Authorization: Bearer <token>'

Response Example

{
  "typebots": [
    {
      "id": "<string>",
      "name": "<string>",
      "icon": "<string>",
      "publishedTypebotId": "<string>"
    }
  ]
}

Request description

Access Token

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

URL Parameters (Query)

Parameter	Type	Description	Required
workspaceId	string	The workspace ID to get bots from.	Yes

---

Response description

Key	Type	Description
typebots	object[]	Toolzz Bots information.
typebots[].id	string	Unique identifier for the bot.
typebots[].name	string	The Toolzz Bot name.
typebots[].icon	string	The visual representation associated with the bot.
typebots[].publishedTypebotId	string	Unique identifier for the published version of the bot.

---

Security

To access this endpoint, it is necessary to send a valid access token through the authorization header (Authorization) of the request.