Skip to main content
POST
/
v1
/
webhooks
/
events
/
{eventId}
/
retry
Retry Event Delivery
curl --request POST \
  --url https://api.example.com/v1/webhooks/events/{eventId}/retry \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "webhookId": {}
}
'
{
  "success": true,
  "data": {
    "eventId": "550e8400-e29b-41d4-a716-446655440000",
    "webhookCount": 2,
    "message": "Event queued for retry to 2 webhook(s)"
  }
}

​
Retry Event Delivery

POST https://api.baanx.com/v1/webhooks/events/{eventId}/retry Manually triggers a retry of event delivery to one or all configured webhook endpoints.

​
Overview

Use this endpoint to resend a failed event or to re-deliver an event to a specific webhook. By default, the event is retried to all currently configured and active webhooks. To target a single webhook, include its ID in the request body.
Retrying queues the event for immediate re-delivery. Monitor results using Get Event Delivery Logs.

​
Authentication

This endpoint requires authentication via Bearer token: 
Authorization: Bearer YOUR_ACCESS_TOKEN

​
Request

​
Headers

​
Authorization
string
required
Bearer token for authentication
​
Content-Type
string
Must be application/json if providing a request body

​
Path Parameters

​
eventId
string (UUID)
required
Unique identifier of the event to retry

​
Body

The request body is optional. Omit it entirely to retry delivery to all configured webhooks.
​
webhookId
string (UUID)
Optional. If provided, retries delivery only to this specific webhook. If omitted, retries to all active configured webhooks.

​
Request Examples

curl -X POST https://api.baanx.com/v1/webhooks/events/550e8400-e29b-41d4-a716-446655440000/retry \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Response

​
200 Success

​
success
boolean
Indicates the retry was successfully queued
​
data.eventId
string (UUID)
ID of the event being retried
​
data.webhookCount
integer
Number of webhooks the event will be delivered to
​
data.message
string
Human-readable confirmation message
{
  "success": true,
  "data": {
    "eventId": "550e8400-e29b-41d4-a716-446655440000",
    "webhookCount": 2,
    "message": "Event queued for retry to 2 webhook(s)"
  }
}

​
Error Responses

{
  "message": "webhookId must be a valid UUID"
}
  • GET /v1/webhooks/events/{eventId}/status - Check event status before retrying
  • GET /v1/webhooks/events/{eventId}/logs - View delivery logs after retrying
  • GET /v1/webhooks/events - List all events and their statuses