# Atualizar etiquetas do WhatsApp

`POST /labels/refresh`

Pasta: **Etiquetas**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Atualizar etiquetas do WhatsApp

Força a releitura do App State de etiquetas no WhatsApp e devolve a lista atualizada do banco. Use quando criou/editou labels no app e elas ainda não aparecem na API.

## Endpoint

`POST {{baseUrl}}/labels/refresh`

## Autenticação

Envie o token da instância no header `token: {{token}}`.

## Corpo da requisição

Nenhum campo é lido pelo handler. Pode enviar body vazio `{}` ou omitir o corpo.

## Exemplo de Requisição

```bash
curl --request POST '{{baseUrl}}/labels/refresh' \
  --header 'token: {{token}}' \
  --header 'Content-Type: application/json' \
  --data-raw '{}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "labels": [
    {
      "id": "lbl_abc123",
      "name": "Cliente",
      "color": 1,
      "colorHex": "#00A884",
      "labelid": "10",
      "owner": "5511999999999"
    }
  ]
}
```

## Erros comuns

- `401 Unauthorized`: token inválido.
- `500 Internal Server Error`: label service indisponível, instância desconectada ou falha no FetchAppState.

## Observações

- Não existe parâmetro `force` nesta rota.
- A resposta já inclui as labels após o refresh (não é só “started”).

## Corpo (exemplo)

```json
{}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/labels/refresh" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=etiquetas/atualizar-etiquetas-do-whatsapp)