> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar pastas

> Liste as pastas na sua conta

Pastas permitem que você agrupe assistentes (por exemplo, por cliente ou marca). Cada assistente pode pertencer a uma única pasta. As pastas são privadas para sua conta.

Este endpoint retorna suas pastas (paginadas), cada uma com o número de assistentes que contém.

### Parâmetros de Consulta

<ParamField query="per_page" type="integer">
  Número de pastas por página (1-100, padrão: 15)
</ParamField>

<ParamField query="page" type="integer">
  Número da página (padrão: 1)
</ParamField>

### Campos de Resposta

<ResponseField name="data" type="array">
  <Expandable title="propriedades">
    <ResponseField name="id" type="integer">O identificador único da pasta</ResponseField>
    <ResponseField name="name" type="string">O nome da pasta</ResponseField>
    <ResponseField name="color" type="string">A cor da pasta (ou `null`)</ResponseField>
    <ResponseField name="assistants_count" type="integer">Número de assistentes nesta pasta</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Resposta de Sucesso theme={null}
  {
    "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
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.