Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

omni-webhooks — Claude Code skill for webhook management

Manage OmniRoute webhook endpoints, event subscriptions and delivery retries. Use it when you need to create, test or remove a webhook through the API.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add cheaper-inference/OmniRoute --skill omni-webhooks -a claude-code
Open on GitHub

What omni-webhooks does

This skill manages OmniRoute webhooks through its API. It can list endpoints, retrieve one by ID, create or update a record, remove it, and trigger a test delivery.

It handles subscriptions for events such as request.completed, request.failed, and quota.exceeded. It can also inspect endpoint deliveries and validate an address before saving it. Request and response schemas are available through GET /api/openapi/spec and docs/openapi.yaml.

Every request needs a valid Bearer token or session cookie. Local development can use REQUIRE_API_KEY=false, so check authentication settings before testing a delivery.

What it helps with

  • register a webhook endpoint
  • subscribe an endpoint to request.failed
  • validate a webhook address before saving
  • trigger a test delivery
  • inspect deliveries for an endpoint

Example prompts for the agent

  • “Create an OmniRoute webhook and subscribe it to `request.completed`.”
  • “Validate this webhook address before saving it.”
  • “Run a test delivery for webhook `<id>` and show its delivery history.”

How to install omni-webhooks

1Skills CLI (Vercel)

npx skills add cheaper-inference/OmniRoute --skill omni-webhooks -a claude-code

2Manually: put the files in place

~/.claude/skills/omni-webhooks/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/omni-webhooks/

From the same set34

The whole set →
cli-setup cheaper-inference Helps the agent configure OmniRoute, manage autostart, apply CLI updates, and adjust session environment variables. Claude Code CX Codex Cursor +1 1,200installs omni-combos-routing cheaper-inference This skill creates and manages model routing combos with fallback chains, tests, and metrics. Use it when OmniRoute needs configurable provider routing. Claude Code CX Codex Cursor +1 1,200installs omni-inference cheaper-inference Connects OpenAI-compatible inference endpoints for chat, embeddings, audio, and images. Useful for AI agents calling OmniRoute endpoints. Claude Code CX Codex Cursor +1 1,100installs cli-providers cheaper-inference Manage OmniRoute provider connections from the CLI: inspect the catalog, test connections, rotate keys, and view metrics. Useful when provider setup is part of your terminal workflow. Claude Code CX Codex Cursor +1 1,100installs omni-auth cheaper-inference Manage API keys and sessions in OmniRoute. Authenticates requests via Bearer tokens, handles dashboard login with password or OIDC, and controls session access. Claude Code CX Codex Cursor +1 1,100installs cli-routing cheaper-inference Manage model routing combos from the command line with omniroute. Test routing strategies, inspect metrics, and configure fallback chains interactively. Claude Code CX Codex Cursor +1 1,100installs omni-mcp cheaper-inference Connects an agent to the OmniRoute MCP server for request routing, memory, cache, and audit work. Use it when those operations need to be available as MCP tools. Claude Code CX Codex Cursor +1 1,100installs omni-providers cheaper-inference Manages connections to 375 AI providers via REST API: adds keys, tests connections, syncs models. Claude Code CX Codex Cursor +1 1,100installs

Similar

bullmq-specialist sickn33 Guides an agent through BullMQ queues backed by Redis, worker handling, and failure cases. Use it for background jobs, schedules, and dependent work. Claude Code CX Codex Cursor +1 2,100installs sql-queries phuryn Generates database queries from natural language descriptions and schema files. Useful for analysts and engineers building data reports across different SQL dialects. Claude Code CX Codex Cursor +1 2,800installs gdpr-compliant official github This skill guides GDPR-aware work with APIs, user data, logs, retention, and deletion. Use it when a code task involves personal data. GitHub Copilot 1,700installs async-io-model tursodatabase Teaches the agent Turso's cooperative async I/O patterns: explicit state machines, IOResult, and avoiding re-entrancy bugs. Claude Code CX Codex Cursor +1 1,300installs mcp-builder official anthropics This skill walks through building an MCP server in TypeScript or Python, from reading the protocol spec to writing tests and evaluation questions. Claude Code Claude.ai 130,949installs lark-im larksuite This skill lets an agent work with Lark IM messages, chats, files, and interactive cards. Use it when coding tasks need access to team conversations. Claude Code CX Codex Cursor +1 472,300installs lark-event larksuite Listens to Lark/Feishu events and streams them as NDJSON. Use it for bots, message processing, and long-running subscribers. Claude Code CX Codex Cursor +1 466,200installs caveman-discover JuliusBrussee Finds and labels every LLM workflow in your repository so Caveman Cloud breaks down spend by actual job rather than grouping everything into one bucket. Claude Code CX Codex Cursor +1 103,500installs

Questions about omni-webhooks

How do I install omni-webhooks in Claude Code?

Run npx skills add cheaper-inference/OmniRoute --skill omni-webhooks -a claude-code. The skill is installed at ~/.claude/skills/omni-webhooks/SKILL.md.

What does omni-webhooks do?

It manages OmniRoute webhook endpoints: creating, listing, updating, testing, and removing them. It also configures event subscriptions and delivery handling.

What does omni-webhooks need to make requests?

Requests require a valid Bearer token or a session cookie. For local development, REQUIRE_API_KEY=false can be configured.

Source text

SKILL.md · MIT
---
name: omni-webhooks
description: Register, list, test, and remove webhook endpoints. Configure event subscriptions (request.completed, request.failed, quota.exceeded, etc.) and manage delivery retries.
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

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

```bash
curl http://localhost:20128/api/webhooks \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
```

### POST /api/webhooks

POST webhooks

```bash
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 › <id>

```bash
curl http://localhost:20128/api/webhooks/{id} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
```

### PUT /api/webhooks/{id}

PUT webhooks › <id>

```bash
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 › <id>

```bash
curl -X DELETE http://localhost:20128/api/webhooks/{id} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
```

### GET /api/webhooks/{id}/deliveries

GET webhooks › <id> › deliveries

```bash
curl http://localhost:20128/api/webhooks/{id}/deliveries \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
```

### POST /api/webhooks/{id}/test

POST webhooks › <id> › test

```bash
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

```bash
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.

© cheaper-inference · MIT · cheaper-inference/OmniRoute

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor