List Folders

Endpoint used to list all folders in a Toolzz Bots workspace.

Request Example

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

Response Example

{
  "folders": [
    {
      "id": "<string>",
      "name": "<string>",
      "workspaceId": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ]
}

Request description

Access Token

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

URL Parameters (Path)

Parameter	Type	Description	Required
workspaceId	string	The unique identifier of the workspace to list folders from.	Yes

---

Response description

Key	Type	Description
folders	object[]	The workspace folders information.
folders[].id	string	The folder unique identifier.
folders[].name	string	The folder name.
folders[].workspaceId	string	Unique identifier of the workspace the folder belongs to.
folders[].createdAt	string	The folder creation date.
folders[].updatedAt	string	The folder last update date.

---

Security

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