About omni-webhooks
omni-webhooks documents API operations for managing webhook endpoints, event subscriptions, and delivery retries. It is for users administering webhook notifications through the OmniRoute API.
Key features
- 01Register, list, update, and remove endpoints
- 02Configure event subscriptions
- 03Inspect webhook deliveries
- 04Test endpoints and validate URLs
- 05Manage delivery retries
Use cases
- 01Set notifications for completed or failed requests
- 02Track quota-exceeded events
- 03Test a webhook before using it
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ cheaper-inference/ omniroute --skill omni-webhooksAfter installing, type/omni-webhooksin Claude Code to confirm it loaded.
Details
From the project READMEOverview
Register, list, test, and remove webhook endpoints. Configure event subscriptions (request.completed, request.failed, quota.exceeded, etc.) and manage delivery retries.
Authentication
All requests require a valid Bearer token or session cookie. Obtain a token via POST /api/auth/login or configure REQUIRE_API_KEY=false for local development.
Endpoints
GET /api/webhooks
GET webhooks
curl http://localhost:20128/api/webhooks \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/webhooks
POST webhooks
curl -X POST http://localhost:20128/api/webhooks \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
GET /api/webhooks/{id}
GET webhooks ›
curl http://localhost:20128/api/webhooks/{id} \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
PUT /api/webhooks/{id}
PUT webhooks ›
curl -X PUT http://localhost:20128/api/webhooks/{id} \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
DELETE /api/webhooks/{id}
DELETE webhooks ›
curl -X DELETE http://localhost:20128/api/webhooks/{id} \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/webhooks/{id}/deliveries
GET webhooks › › deliveries
curl http://localhost:20128/api/webhooks/{id}/deliveries \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/webhooks/{id}/test
POST webhooks › › test
curl -X POST http://localhost:20128/api/webhooks/{id}/test \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
POST /api/webhooks/validate-url
POST webhooks › validate url
curl -X POST http://localhost:20128/api/webhooks/validate-url \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
Payloads
See the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.