Events API
POST /v1/projects/:id/events/:eid/replay
Replay an existing event by re-queuing it for delivery to all linked destinations.
Authentication
Requires JWT. The authenticated user must own the project.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | UUID | Project ID |
eid | UUID | Event ID |
Response
200 OK
{
"message": "event replayed",
"destinations": 3
}
Error Responses
| Status | Description |
|---|---|
400 Bad Request | Invalid project or event ID format |
404 Not Found | Project or event not found |
500 Internal Server Error | Failed to fetch destinations |
503 Service Unavailable | Delivery queue unavailable |
Behavior
- Uses the current endpoint-destination configuration (templates, transforms, routing rules)
- Creates new delivery attempts — does not modify existing ones
- The original event payload is used (transforms are re-applied at delivery time)
POST /v1/projects/:id/sources/:eid/test
Send a synthetic test event through an endpoint.
Authentication
Requires JWT. The authenticated user must own the project. The endpoint must belong to the project.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | UUID | Project ID |
eid | UUID | Endpoint ID |
Request Body (Optional)
{
"payload": {
"action": "test",
"repository": {
"full_name": "owner/repo"
}
}
}
If no payload is provided, a default is used:
{
"test": true,
"message": "Hello from Dispatch!"
}
Response
202 Accepted
{
"event_id": "550e8400-e29b-41d4-a716-446655440000",
"destinations": 2
}
Behavior
- Creates a real event with
event_type = "test" - Event is stored and processed normally
- Delivery is attempted to all active linked destinations
- Useful for testing templates, transforms, and destination connectivity