API Reference
Webhooks
Receive real-time notifications when executions fail, use fallback, or complete successfully. Configure endpoints to integrate with Slack, n8n, Make, or any HTTP system.
Setup
Go to Dashboard → Webhooks and click + New Webhook. Configure:
| Field | Description |
|---|---|
| Nome | Webhook identifier (e.g.: "Slack — Failure alerts") |
| URL | Endpoint that will receive events |
| Secret | Optional. Signs the payload with HMAC-SHA256 |
| Eventos | Which events trigger the webhook |
Available events
| Event | When it fires |
|---|---|
execution.failed | All retries failed and there is no safe fallback |
execution.fallback | Primary provider failed, used fallback (provider or safe) |
execution.success | Output validated successfully |
Payload
Reliant sends a POST with Content-Type: application/json:
json
{
"event": "execution.failed",
"execution_id": "exec_...",
"schema_id": "sch_...",
"provider": "anthropic",
"model": "claude-sonnet-4-20250514",
"attempts": 3,
"latency_ms": 4521,
"status": "FAILED",
"timestamp": "2026-05-17T12:00:00Z"
}
Signature verification
If you configured a secret, Reliant sends the X-Reliant-Signature header with the HMAC-SHA256 signature of the payload:
javascript
import crypto from 'crypto'
function verifySignature(payload, signature, secret) {
const expected = 'sha256=' + crypto
.createHmac('sha256', secret)
.update(payload)
.digest('hex')
return crypto.timingSafeEqual(
Buffer.from(signature),
Buffer.from(expected)
)
}
// In your endpoint:
app.post('/webhook', (req, res) => {
const signature = req.headers['x-reliant-signature']
const valid = verifySignature(
JSON.stringify(req.body),
signature,
'your-secret'
)
if (!valid) return res.status(401).send('Unauthorized')
// process event...
})
API Endpoints
List webhooks
http
GET /webhooks?user_id=your-user-id
Create webhook
http
POST /webhooks
{
"user_id": "your-user-id",
"name": "Slack Alerts",
"url": "https://hooks.slack.com/services/...",
"events": ["execution.failed", "execution.fallback"]
}
Test webhook
http
POST /webhooks/:id/test
Delete webhook
http
DELETE /webhooks/:id