Skip to main content
ClaudeWave
Skill64.3k repo starsupdated yesterday

omni-webhooks

The omni-webhooks skill enables registration, listing, testing, and removal of webhook endpoints within the OmniRoute system. Use it to configure event subscriptions for key lifecycle events such as request completion, provider errors, and budget threshold violations, while managing retry policies for reliable webhook delivery.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/diegosouzapw/OmniRoute /tmp/omni-webhooks && cp -r /tmp/omni-webhooks/skills/omni-webhooks ~/.claude/skills/omni-webhooks
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

<!-- 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 https://localhost:20128/api/webhooks \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
```

### POST /api/webhooks

POST webhooks

```bash
curl -X POST https://localhost:20128/api/webhooks \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
```

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

GET webhooks › <id>

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

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

PUT webhooks › <id>

```bash
curl -X PUT https://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 https://localhost:20128/api/webhooks/{id} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
```

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

GET webhooks › <id> › deliveries

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

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

POST webhooks › <id> › test

```bash
curl -X POST https://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 https://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.