Webhook

Send trace payloads to any custom HTTP endpoint

Webhook destination is the most flexible option when you run your own telemetry ingestion service. TheRouter.ai sends OTLP JSON, including model metadata and usage fields.

broadcast-webhook-config.json

{
  "destination": "webhook",
  "enabled": true,
  "url": "https://telemetry.example.com/therouter/traces",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer webhook_token",
    "X-Signature": "rotating-secret"
  },
  "sampling_rate": 1
}

cURL

curl https://api.therouter.ai/v1/chat/completions   -H "Authorization: Bearer $THEROUTER_API_KEY"   -H "Content-Type: application/json"   -H "X-TheRouter.ai-Broadcast: true"   -d '{
    "model":"anthropic/claude-sonnet-4.5",
    "messages":[{"role":"user","content":"Summarize this policy"}],
    "trace":{"trace_name":"Webhook Sink Test","priority":"high"}
  }'

Respond with 2xx

Your endpoint should return a 2xx status quickly and process payloads asynchronously. Slow or non-2xx responses can trigger retries and dropped traces.