> ## 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.

# Criar etiqueta

> Crie uma etiqueta para marcar seus assistentes

Crie uma etiqueta para marcar assistentes em pastas (por exemplo, `entrada` ou `saída`). Aplique etiquetas aos assistentes com o campo `label_ids` nos endpoints de [Criar assistente](/api-reference/assistants/create-assistant) e [Atualizar assistente](/api-reference/assistants/update-assistant).

### Corpo da Requisição

<ParamField body="name" type="string" required>
  O nome da etiqueta (máx. 255 caracteres). Deve ser único dentro da sua conta.
</ParamField>

<ParamField body="color" type="string">
  Uma cor para o badge da etiqueta. Uma das opções: `gray`, `slate`, `red`, `orange`, `amber`, `green`, `teal`, `blue`, `purple`, `pink`.
</ParamField>

### Resposta

<ResponseField name="message" type="string">Mensagem de sucesso</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="propriedades">
    <ResponseField name="id" type="integer">O identificador único da etiqueta criada</ResponseField>
    <ResponseField name="name" type="string">O nome da etiqueta</ResponseField>
    <ResponseField name="color" type="string">A cor da etiqueta (ou `null`)</ResponseField>
    <ResponseField name="assistants_count" type="integer">Número de assistentes aos quais esta etiqueta está aplicada (sempre `0` para uma nova etiqueta)</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 201 Resposta de Sucesso theme={null}
  {
    "message": "Etiqueta criada com sucesso",
    "data": { "id": 3, "name": "Entrada", "color": "green", "assistants_count": 0 }
  }
  ```

  ```json 422 Erro de Validação theme={null}
  {
    "message": "O nome já foi utilizado.",
    "errors": { "name": ["O nome já foi utilizado."] }
  }
  ```
</ResponseExample>


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