VoxLink.ai

API Reference

List folders

List the folders in your account

Updated 30 June 2026

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

idinteger

The unique identifier of the folder

namestring

The folder name

colorstring

The folder color (or null)

assistants_countinteger

Number of assistants in this folder

{
  "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