omni-combos-routing

Files (1)

• SKILL.md

SKILL.md (first lines)

<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

Create and manage routing combos with 14 strategies (priority, weighted, round-robin, Auto-combo, etc.). Configure fallback chains, test routing outcomes, and retrieve combo metrics.

## 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/combos

List routing combos

```bash
curl https://localhost:20128/api/combos \
  -H "Authorization: Bearer $AIRoute_TOKEN"
```

### POST /api/combos

Create routing combo

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

### PATCH /api/combos/{id}

Update combo

```bash
curl -X PATCH https://localhost:20128/api/combos/{id} \
  -H "Authorization: Bearer $AIRoute_TOKEN"
  -H "Content-Type: application/json" \
  -d '{}'
```

### DELETE /api/combos/{id}

Delete combo

```bash
curl -X DELETE https://localhost:20128/api/combos/{id} \
  -H "Authorization: Bearer $AIRoute_TOKEN"
```

### GET /api/combos/metrics

Get combo metrics

```bash
curl https://localhost:20128/api/combos/metrics \
  -H "Authorization: Bearer $AIRoute_TOKEN"
```

### POST /api/combos/test

Test a combo configuration

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

### GET /api/fallback/chains

List fallback chains

Returns all registered fallback chains for model routing.

```bash
curl https://localhost:20128/api/fallback/chains \
  -H "Authorization: Bearer $AIRoute_TOKEN"
```

### POST /api/fallback/chains

Create fallback chain

Registers a fallback routing chain for a model.

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

### DELETE /api/fallback/chains

Delete fallback chain

```bash
curl -X DELETE https://localhost:20128/api/fallback/chains \
  -H "Authorization: Bearer $AIRoute_TOKEN"
```

## Payloads

See the full OpenAPI specification at `GET /api/openapi/spec` or `docs/openapi.yaml` for detailed request/response schemas.

<!-- skill:custom-start -->
<!-- Migrated from skills/AIRoute-routing/SKILL.md (preserved curated content) -->

# AIRoute — Routing & Combos

Requires `AIRoute_URL` and `AIRoute_KEY`. See [entry-point SKILL](https://raw.githubusercontent.com/diegosouzapw/AIRoute/main/skills/AIRoute/SKILL.md) for setup.

## What is a combo?

A combo is a named group of providers/models with a routing strategy. All requests through a combo are automatically distributed, failed-over, and load-balanced — the caller uses a single model ID like `my-combo`.

From jaccen/AIRoute, Apache-2.0.

More from jaccen/AIRoute