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.
47 operations
| Method | Path | Required permission | Authentication | Summary |
|---|---|---|---|---|
| post | /v1/m/finops/admission/commit | finops:budget:write | Bearer token | Settles a hold with the cost the effect actually incurred, returning whatever headroom the estimate held beyond it. |
| post | /v1/m/finops/admission/reconcile | finops:budget:write | Bearer token | Runs admission recovery, sweeps holds that expired unsettled, compares what remains against the commits and releases its callers made, and files a posture finding when the ledger drifted. |
| get | /v1/m/finops/admission/reconciliation | finops:budget:read | Bearer token | Reports the reservation ledger against its commits and releases, and what recovery left outstanding: holds still owed, claims and releases an earlier build left, undecided recovery writes, and admission rows that fail their integrity check. |
| post | /v1/m/finops/admission/release | finops:budget:write | Bearer token | Returns an unused hold to its budget when the effect did not happen, so an abandoned reservation stops withholding headroom from the next caller. |
| post | /v1/m/finops/admission/reserve | finops:budget:write | Bearer token | Holds the estimated spend of a billable effect against every enforcing budget that scopes the request, and against the named actor's spend limits, under one handle. |
| 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 | finops module route (requires finops:spend:read) |
| 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 | finops module route (requires finops:spend:read) |
| 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 | finops module route (requires finops:spend:read) |
| post | /v1/m/finops/model-rates | finops:budget:write | Bearer token | finops module route (requires finops:budget:write) |
| get | /v1/m/finops/model-rates/{id} | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| put | /v1/m/finops/model-rates/{id} | finops:budget:write | Bearer token | finops module route (requires finops:budget:write) |
| delete | /v1/m/finops/model-rates/{id} | finops:budget:write | Bearer token | finops module route (requires finops:budget:write) |
| get | /v1/m/finops/outcomes | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| post | /v1/m/finops/outcomes | finops:outcomes:write | Bearer token | finops module route (requires finops:outcomes:write) |
| 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 | finops module route (requires finops:seats:write) |
| get | /v1/m/finops/seats/utilization | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |
| 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 | finops module route (requires finops:spend:read) |
| get | /v1/m/finops/value/summary | finops:spend:read | Bearer token | finops module route (requires finops:spend:read) |