Switchyard lets LLM applications route traffic across models and providers while preserving native OpenAI and Anthropic API compatibility - enabling flexible model selection, benchmarking, and cost/performance optimization.
Rust
docs(server): document the HTTP endpoints (#228)
ryan-lempkabc5d78c141ec
diff --git a/crates/switchyard-server/README.md b/crates/switchyard-server/README.mdindex 27c0bd3d2..343c14da8 100644--- a/crates/switchyard-server/README.md+++ b/crates/switchyard-server/README.md@@ -101,6 +101,24 @@ tier per turn, without an extra classifier call on every turn. `capable_target`,are required. Optional handoff notes, per-tier system prompts, and a capability-judge fallback aredocumented in [Stage-Router Routing](../../docs/routing_algorithms/stage_router_routing.md).+## Endpoints++| Method | Path | Purpose |+|---|---|---|+| `POST` | `/v1/chat/completions` | OpenAI Chat Completions |+| `POST` | `/v1/messages` | Anthropic Messages |+| `POST` | `/v1/responses` | OpenAI Responses |+| `POST` | `/v1/messages/count_tokens` | Anthropic token count |+| `GET` | `/v1/models` | Routes served by this deployment |+| `GET` | `/v1/stats` | Per-model request, token, and cost totals |+| `POST` | `/v1/stats/reset` | Clear accumulated stats |+| `GET` | `/metrics` | Prometheus text, see [Metrics](#metrics) |+| `GET` | `/health` | Liveness |++Requests name a route by its `id`, so `POST /v1/chat/completions` with `"model": "switchyard/general"`+routes through the `[routes.general]` entry above. Any of the three request formats can address any+route, and the server translates between them.+## Metrics`GET /metrics` exposes Prometheus text from the server's process-wide OpenTelemetry provider.