# Limpar fila de envio assíncrono

`DELETE /message/async`

Pasta: **Mensagem Async**

## Autenticação

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

## Descrição

# Limpar fila de envio assíncrono

Cancela/drena jobs pendentes da fila `async` da instância. Use com cuidado: mensagens ainda não enviadas serão descartadas/canceladas.

## Endpoint

`DELETE {{baseUrl}}/message/async`

## Autenticação

Header obrigatório: `token: {{token}}`.

## Parâmetros

Nenhum. A instância vem do token.

## Exemplo de Requisição

```bash
curl -X DELETE "{{baseUrl}}/message/async" \
  -H "token: {{token}}"
```

## Resposta de Sucesso

```json
{
  "response": "Async queue cleared",
  "instanceId": "r183e2ef9597845",
  "stats": {
    "trackedJobsCleared": 10,
    "bufferedJobsMarkedCanceled": 2,
    "drainedChannelJobs": 8,
    "clearedOverflowJobs": 0,
    "persistedQueuedCanceled": 10
  }
}
```

## Erros comuns

- `401` — token ausente ou inválido
- `409` — fila ainda não drenou (`async queue not drained`), com `stats` no body
- `500` — fila indisponível

## Observações

- Durante o clear, `acceptingNewMessages` pode ficar `false` temporariamente (`resetting`).

## cURL

```bash
curl -X DELETE "{{baseUrl}}/message/async" \
  -H "token: {{token}}"
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=mensagem-async/limpar-fila-de-envio-assincrono)