Pular para o conteúdo

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.

Ver em Markdown

Parâmetros de caminho

idstringobrigatório

Identificador da entrega: o id de uma linha de GET /webhooks/deliveries.

Respostas

Respostas: código de status, erro e descrição
CódigoErro e descrição
200A entrega, já na fila: state retry, attempts 0 e nextAttemptAt agora. httpStatus, error e latencyMs ainda são da última tentativa antes do reenvio.
400FST_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.
401Sem chave de API, ou com uma chave inválida: desconhecida, revogada ou expirada. O corpo é {"error": "Unauthorized"}.
403A chave não tem o escopo webhooks:write; a mensagem cita o escopo (This credential lacks the webhooks:write scope).
404A entrega não existe, saiu do registro (depois da retenção) ou não é do projeto da chave ({"error": "Delivery not found"}).
409A 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.
429Requisiçõ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