Reenviar entrega
POST/webhooks/deliveries/{id}/resend
Coloca uma entrega de webhook de novo na fila, para agora, com as tentativas zeradas (mais 6 tentativas). Serve para uma entrega dead ou em retry (neste caso, a próxima tentativa é antecipada); uma entrega já entregue responde 409. Escopo necessário: webhooks:write.
Parâmetros de caminho
idstringobrigatórioIdentificador da entrega: o id de uma linha de GET /webhooks/deliveries.
Respostas
| Código | Erro e descrição |
|---|---|
| 200 | A entrega, já na fila: state retry, attempts 0 e nextAttemptAt agora. httpStatus, error e latencyMs ainda são da última tentativa antes do reenvio. |
| 400 | FST_ERR_VALIDATIONO id não segue o schema da operação. Na prática não acontece, porque o id aceita qualquer texto; um id que não existe responde 404; message diz o que está errado. |
| 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). |
| 404 | A entrega não existe, saiu do registro (depois da retenção) ou não é do projeto da chave ({"error": "Delivery not found"}). |
| 409 | A entrega já foi feita com sucesso (Delivery already succeeded; nothing to resend), ou o corpo dela não foi guardado por ter mais de 256 KB e ela já saiu da fila interna, então não há como montá-la de novo (Payload not available for resend (too large to be logged)). Neste caso a entrega fica como estava. |
| 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.Cabeçalho: Retry-After |
Detalhes
O evento sai de novo com o mesmo corpo, envelope incluído, e é assinado de novo com o segredo atual do projeto. Trate os eventos pelo que já recebeu: a entrega é pelo menos uma vez.
Acompanhe o resultado em GET /webhooks/deliveries: a mesma linha (mesmo id) é atualizada a cada tentativa.
Guia: Webhooks e assinatura
Esta página ajudou? · Atualizado em 28 set 2026