> ## 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 rótulos

> Liste os rótulos na sua conta

Rótulos são tags que você pode aplicar aos assistentes. Ao contrário das pastas, um assistente pode ter múltiplos rótulos, e um rótulo pode ser aplicado a muitos assistentes. Os rótulos são privados à sua conta.

Este endpoint retorna seus rótulos (paginados), cada um com o número de assistentes ao qual está aplicado.

### Parâmetros de Consulta

<ParamField query="per_page" type="integer">
  Número de rótulos 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 do rótulo</ResponseField>
    <ResponseField name="name" type="string">O nome do rótulo</ResponseField>
    <ResponseField name="color" type="string">A cor do rótulo (ou `null`)</ResponseField>
    <ResponseField name="assistants_count" type="integer">Número de assistentes aos quais este rótulo está aplicado</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Resposta de Sucesso theme={null}
  {
    "data": [
      { "id": 3, "name": "Entrada", "color": "green", "assistants_count": 7 },
      { "id": 5, "name": "Saída", "color": "blue", "assistants_count": 2 }
    ],
    "current_page": 1,
    "per_page": 15,
    "total": 2
  }
  ```
</ResponseExample>


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