# BrainstormRouter Intelligence API

**Canonical:** https://apis.io/apis/brainstormrouter-com/brainstormrouter-com-intelligence-api/  
**Provider:** BrainstormRouter — https://apis.io/providers/brainstormrouter-com/  
**Base URL:** https://api.brainstormrouter.com  
**Documentation:** https://brainstormrouter.com/developers

BrainstormRouter Intelligence API is one of 73 APIs that [BrainstormRouter](https://apis.io/providers/brainstormrouter-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Intelligence. The published artifact set on APIs.io includes an OpenAPI specification.

The intelligence API from BrainstormRouter — 38 operation(s) for intelligence.

## Operations (42)

| Method | Path | Summary |
|---|---|---|
| GET | `/auth/ops/guardian-stats` | Guardian overhead, cache hit rate, anomaly count — dashboard JWT |
| GET | `/auth/routing/cascades` | Cascade activations (model escalation on failure) — dashboard JWT |
| GET | `/auth/routing/decisions` | Recent routing decisions with decisionTrace metadata (dashboard JWT) |
| GET | `/v1/agent/reputation` | Caller's own agent reputation: score, tier, and tier multipliers |
| GET | `/v1/agent/trajectories` | Query stored trajectories with filters (project, request_type, source, limit… |
| POST | `/v1/agent/trajectories` | Record an orchestration trajectory for the current tenant |
| GET | `/v1/agent/trajectories/export` | Export trajectories as JSONL for offline training pipelines |
| GET | `/v1/agent/trajectories/stats` | Aggregate statistics over stored trajectories for the current tenant |
| POST | `/v1/compare` | Fan a prompt out to 2–6 models in parallel and compare cost/latency/quality |
| POST | `/v1/consensus` | Evaluate multi-model consensus (majority/quality/weighted) with optional fan-out |
| POST | `/v1/estimate` | Predict per-model cost for a completion request (no provider calls) |
| GET | `/v1/experiments` | List experiments for the tenant |
| POST | `/v1/experiments` | Create an A/B-test experiment with weighted variants |
| GET | `/v1/experiments/{id}` | Get an experiment with interim results + statistical significance |
| POST | `/v1/experiments/{id}/outcomes` | Record an outcome for an experiment variant |
| GET | `/v1/explain/{request_id}` | Per-request routing-decision trace; optional LLM-narrated postmortem |
| POST | `/v1/feedback/{requestId}` | Report outcome (success/partial/failure) for a routed request; the reward… |
| GET | `/v1/fleet/insights` | Fleet model insights — top 10 by evaluations or model-specific |
| POST | `/v1/intelligence/advise` | Predictive routing recommendation with reasoning, evidence, and alternatives |
| GET | `/v1/intelligence/benchmark` | Thompson-vs-static shadow comparator results + statistical significance |
| GET | `/v1/intelligence/compare` | Head-to-head comparison of 2-10 models |
| GET | `/v1/intelligence/degradation` | Current degradation ladder state: level, reason, thresholds, budget utilization |
| GET | `/v1/intelligence/deprecations` | Active deprecation alerts (filter by provider, level) |
| GET | `/v1/intelligence/frontier` | Cost-quality Pareto frontier with dominated models |
| GET | `/v1/intelligence/model/{provider}/{modelId}` | Single model profile with ranking + deprecation alert |
| GET | `/v1/intelligence/patterns` | Aggregated request-pattern × model performance data with optional filters |
| GET | `/v1/intelligence/rankings` | Overall (or task-specific) model leaderboard |
| GET | `/v1/intelligence/savings` | Counterfactual ROI savings (Postgres-backed when configured) |
| GET | `/v1/intelligence/status` | Ingestor diagnostics, store size, deprecation alert count |
| GET | `/v1/liaison/{liaison_id}/events` | SSE stream of routing decisions and trace envelopes scoped to a liaison session |
| GET | `/v1/ops/guardian-stats` | Guardian overhead, cache hit rate, anomaly count (24h) |
| POST | `/v1/patterns` | Store a learned task pattern (tenant-scoped) |
| GET | `/v1/patterns/recommend` | Aggregated task-pattern recommendations across all tenants |
| POST | `/v1/recommend` | Ranked model recommendations backed by production routing data |
| POST | `/v1/route` | Brainstorm CLI delegated routing — pick a model for a task spec |
| GET | `/v1/routing-stream` | SSE stream of live routing events for the tenant: route-time decisions… |
| DELETE | `/v1/routing/canary` | Remove canary configuration |
| GET | `/v1/routing/canary` | Read current canary configuration |
| POST | `/v1/routing/canary` | Set the canary traffic-split configuration for the current tenant |
| GET | `/v1/routing/canary/results` | Per-variant outcome statistics for the active canary |
| GET | `/v1/routing/cascades` | Cascade activations (model escalation on failure) |
| GET | `/v1/routing/decisions` | Recent routing decisions with decisionTrace metadata |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/brainstormrouter-com/openapi/brainstormrouter-com-intelligence-api-openapi.yml

## Other BrainstormRouter APIs (12)

- [BrainstormRouter A2a API](https://apis.io/apis/brainstormrouter-com/brainstormrouter-com-a2a-api/)
- [BrainstormRouter Admin API](https://apis.io/apis/brainstormrouter-com/brainstormrouter-com-admin-api/)
- [BrainstormRouter Agent API](https://apis.io/apis/brainstormrouter-com/brainstormrouter-com-agent-api/)
- [BrainstormRouter Agent Bootstrap API](https://apis.io/apis/brainstormrouter-com/brainstormrouter-com-agent-bootstrap-api/)
- [BrainstormRouter Agent Manifests API](https://apis.io/apis/brainstormrouter-com/brainstormrouter-com-agent-manifests-api/)
- [BrainstormRouter Agent Onboarding API](https://apis.io/apis/brainstormrouter-com/brainstormrouter-com-agent-onboarding-api/)
- [BrainstormRouter Agent Profiles API](https://apis.io/apis/brainstormrouter-com/brainstormrouter-com-agent-profiles-api/)
- [BrainstormRouter Agents API](https://apis.io/apis/brainstormrouter-com/brainstormrouter-com-agents-api/)
- [BrainstormRouter Analytics API](https://apis.io/apis/brainstormrouter-com/brainstormrouter-com-analytics-api/)
- [BrainstormRouter Anomaly API](https://apis.io/apis/brainstormrouter-com/brainstormrouter-com-anomaly-api/)
- [BrainstormRouter API Keys API](https://apis.io/apis/brainstormrouter-com/brainstormrouter-com-api-keys-api/)
- [BrainstormRouter Approvals API](https://apis.io/apis/brainstormrouter-com/brainstormrouter-com-approvals-api/)

## Tags

Intelligence

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/brainstormrouter-com/brainstormrouter-com-intelligence-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/brainstormrouter-com/.