Skip to main content
GET
/
user
/
folders
List folders
curl --request GET \
  --url https://app.autocalls.ai/api/user/folders \
  --header 'Authorization: Bearer <token>'
{
  "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
}
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_page
integer
Number of folders per page (1-100, default: 15)
page
integer
Page number (default: 1)

Response fields

data
array
{
  "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
}