Beta module namespace
finops
Beta routes may change with notice and are NOT covered by the 24-month stable window of the core contract.
Every module route is enumerated with method, path, auth and required permission; request/response schemas are not published for the beta surface.
42 operations
| Method | Path | Required permission | Authentication | Summary |
|---|---|---|---|---|
| get | /v1/m/finops/alerts | finops:budget:read | Bearer token | finops module route (requires finops:budget:read) |
| get | /v1/m/finops/analytics/team-summary | finops:spend:read | Bearer token | Returns team-level cost aggregation with project/model breakdown and a per-calendar-day trend series for a fixed period (7d/30d/90d). |
| get | /v1/m/finops/budgets | finops:budget:read | Bearer token | finops module route (requires finops:budget:read) |
| post | /v1/m/finops/budgets | finops:budget:write | Bearer token | finops module route (requires finops:budget:write) |
| get | /v1/m/finops/budgets/{id} | finops:budget:read | Bearer token | finops module route (requires finops:budget:read) |
| put | /v1/m/finops/budgets/{id} | finops:budget:write | Bearer token | finops module route (requires finops:budget:write) |
| delete | /v1/m/finops/budgets/{id} | finops:budget:write | Bearer token | finops module route (requires finops:budget:write) |
| get | /v1/m/finops/budgets/{id}/status | finops:budget:read | Bearer token | finops module route (requires finops:budget:read) |
| get | /v1/m/finops/comparison | finops:spend:read | Bearer token | Serves GET /comparison — the model cost comparison endpoint. |
| post | /v1/m/finops/cost | finops:cost:write | Bearer token | Ingests one CostSample over HTTP (the Anthropic cost_report or a live runtime-cost sample) through the SAME canonical onCost path the bus uses — so it shares the natural-key dedup, the attribution resolution and the single-provenance CostRecord ledger; it never opens a second divergent path. |
| get | /v1/m/finops/cost-centers | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| post | /v1/m/finops/cost-centers | finops:budget:write | Bearer token | finops module route (requires finops:budget:write) |
| get | /v1/m/finops/cost-centers/{id} | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| put | /v1/m/finops/cost-centers/{id} | finops:budget:write | Bearer token | finops module route (requires finops:budget:write) |
| delete | /v1/m/finops/cost-centers/{id} | finops:budget:write | Bearer token | finops module route (requires finops:budget:write) |
| get | /v1/m/finops/cost-centers/{id}/mappings | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| post | /v1/m/finops/cost-centers/{id}/mappings | finops:budget:write | Bearer token | finops module route (requires finops:budget:write) |
| delete | /v1/m/finops/cost-centers/{id}/mappings/{mid} | finops:budget:write | Bearer token | finops module route (requires finops:budget:write) |
| get | /v1/m/finops/forecast | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| get | /v1/m/finops/model-rates | finops:spend:read | Bearer token | Lists rate catalog entries with optional provider/model filters, sorted by effective_from descending (most recent first). |
| post | /v1/m/finops/model-rates | finops:budget:write | Bearer token | Creates a new rate catalog entry after validating input and checking uniqueness of the (provider, model, effective_from) tuple. |
| get | /v1/m/finops/model-rates/{id} | finops:spend:read | Bearer token | Returns a single rate catalog entry by ID. |
| put | /v1/m/finops/model-rates/{id} | finops:budget:write | Bearer token | Replaces a rate catalog entry by ID. |
| delete | /v1/m/finops/model-rates/{id} | finops:budget:write | Bearer token | Removes a rate catalog entry by ID. |
| get | /v1/m/finops/outcomes | finops:spend:read | Bearer token | Lists graded outcomes, optionally filtered by subject. |
| post | /v1/m/finops/outcomes | finops:outcomes:write | Bearer token | Ingests one graded outcome over HTTP (the operator/automation bridge), auditing the principal's privileged write atomically with its effect. |
| get | /v1/m/finops/recommendations | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| post | /v1/m/finops/seats | finops:seats:write | Bearer token | Upserts one provider/day seat snapshot (202 Accepted: a re-posted day replaces its values — a snapshot, never additive). |
| get | /v1/m/finops/seats/utilization | finops:spend:read | Bearer token | Joins the seat denominators with the per-day distinct active actors for a provider over an inclusive [from, to] day range. |
| get | /v1/m/finops/spend | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| get | /v1/m/finops/spend/allocation | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| get | /v1/m/finops/spend/export | finops:spend:read | Bearer token | Streams the cost read-model as a FOCUS-conformant CSV. |
| get | /v1/m/finops/spend/reconciliation | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| get | /v1/m/finops/spend/summary | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| get | /v1/m/finops/spend/trend | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| get | /v1/m/finops/spend/unified | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| get | /v1/m/finops/statements | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| post | /v1/m/finops/statements/generate | finops:budget:write | Bearer token | finops module route (requires finops:budget:write) |
| get | /v1/m/finops/statements/{id} | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| get | /v1/m/finops/statements/{id}/export | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| get | /v1/m/finops/value | finops:spend:read | Bearer token | Serves the cost-per-outcome breakdown by ?dimension (agent|identity| session, default agent) over the standard since/until window. |
| get | /v1/m/finops/value/summary | finops:spend:read | Bearer token | Serves the CFO panel (totals + cancellation-risk list). |