Skip to main content

POST Reenviar Evento

Reenvia o evento às entregas que falharam (FAILED) de endpoints ativos, com o mesmo id e o ciclo completo de retentativas. Só é possível dentro da janela de retenção de 2 dias.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige a permissão manage_webhooks.


Endpoint​

POST https://api-dev.imagemais.com.br/api/webhooks/events/{eventId}/redeliver

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
eventIdstring✅ID do evento (evt_…)

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/webhooks/events/evt_01M4E8BB44BXNGF09XM1FAB8Z9/redeliver' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

202 Aceito​

{
"event_id": "evt_01M4E8BB44BXNGF09XM1FAB8Z9",
"deliveries": 1
}

deliveries é o número de entregas recolocadas na fila.

403 Sem permissão​

{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}

404 Não encontrado​

{
"message": "Evento de webhook não encontrado",
"error": "Not Found",
"statusCode": 404
}

422 Regra de negócio​

{
"message": "O evento não tem entrega com falha para endpoint ativo",
"error": "Unprocessable Entity",
"statusCode": 422
}