# Reenviar entregas mortas

Fonte: https://apiwpp.com/docs/api/registros/reenviar-entregas-mortas
Seção: Registros
Atualizado em: 2026-09-28

`POST /webhooks/deliveries/resend-dead`

Coloca de novo na fila todas as entregas de webhook no estado `dead` do projeto da chave, das mais novas para as mais antigas, no máximo 1000 por chamada. Cada uma volta para `retry`, com as tentativas zeradas e a próxima para agora. Escopo necessário: `webhooks:write`.

## Cabeçalhos

| Nome | Obrigatório | Descrição |
| --- | --- | --- |
| `Authorization` | sim | `Bearer <chave de API>`; ou envie a chave em `X-Api-Key`. |

## Exemplo de requisição

### cURL

```bash
curl -X POST \
  https://api.apiwpp.com/webhooks/deliveries/resend-dead \
  -H "Authorization: Bearer $API_KEY"
```

### Node.js

```javascript
const res = await fetch(`https://api.apiwpp.com/webhooks/deliveries/resend-dead`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
  },
})
const data = await res.json()
```

### PHP

```php
$response = Http::withToken($apiKey)
    ->post("https://api.apiwpp.com/webhooks/deliveries/resend-dead");
```

### Python

```python
import requests

response = requests.post(
    "https://api.apiwpp.com/webhooks/deliveries/resend-dead",
    headers={"Authorization": f"Bearer {API_KEY}"},
)
```

## Respostas

| Código | Erro | Descrição |
| --- | --- | --- |
| 200 |  | `requeued`, quantas entregas voltaram para a fila. É `0` quando não há nenhuma entrega `dead`. |
| 401 |  | Sem chave de API, ou com uma chave inválida: desconhecida, revogada ou expirada. O corpo é `{"error": "Unauthorized"}`. |
| 403 |  | A chave não tem o escopo `webhooks:write`; a mensagem cita o escopo (`This credential lacks the webhooks:write scope`). |
| 429 |  | Requisições demais deste IP de origem (por padrão, 600 por minuto), ou autenticações com falha demais (por padrão, 20 a cada 5 minutos): espere os segundos de `Retry-After`. Veja [Limites](https://apiwpp.com/docs/referencia/limites). Cabeçalhos: `Retry-After`. |

### 200 OK

```json
{
  "requeued": 3
}
```

## Detalhes

Não tem corpo nem filtros. Use depois de corrigir o seu endpoint: as entregas saem de novo com o mesmo corpo de antes, então trate os eventos pelo que já recebeu (a entrega é pelo menos uma vez).

Uma entrega cujo corpo não foi guardado (mais de 256 KB) e que já saiu da fila interna da apiwpp não pode ser reenviada: ela continua `dead`, com `error` igual a `payload not available for resend`, e não entra em `requeued`. Como ela continua `dead`, ela é considerada de novo na próxima chamada.

Com mais de 1000 entregas `dead`, chame de novo depois para reenviar as seguintes. As que não têm o corpo guardado continuam `dead` e voltam a ocupar as 1000 vagas da próxima chamada: se `requeued` vier abaixo de 1000 e ainda houver entregas `dead` mais antigas, reenvie essas uma a uma com `POST /webhooks/deliveries/{id}/resend`.

Guia: [Webhooks e assinatura](https://apiwpp.com/docs/guias/webhooks-e-assinatura).
