API Reference
List folders
List the folders in your account
Updated 30 June 2026
On this page
Folders let you group assistants (for example, by client or brand). Each assistant can belong to a single folder. Folders are private to your account.
This endpoint returns your folders (paginated), each with the number of assistants it contains.
Query Parameters
per_pageinteger
Number of folders per page (1-100, default: 15)
pageinteger
Page number (default: 1)
Response fields
dataarray
{
"data": [
{ "id": 12, "name": "Acme Corp", "color": "blue", "assistants_count": 4 },
{ "id": 18, "name": "Globex", "color": "teal", "assistants_count": 0 }
],
"current_page": 1,
"per_page": 15,
"total": 2
}
Related guides
API Reference
Introduction
Welcome to the VoxLink API
Read guide →API Reference
Authentication
Learn how to authenticate your API requests
Read guide →API Reference
Get current user
Get the authenticated user's profile information
Read guide →API Reference
List assistants
List all assistants for the authenticated user with pagination
Read guide →