Credit, debit, or adjust budget allocation
Modifies budget allocation and remaining balance outside the reservation flow. Common operations:
AUTHORIZATION: - Tenant can fund their own budgets only
CREDIT (top-up): - allocated += amount - remaining += amount - Use for: monthly allocations, bonus credits
DEBIT (drain): - allocated -= amount - remaining -= amount (fails if would go negative) - Use for: downgrades, refunds, policy enforcement
RESET (reallocate): - allocated = amount - remaining = amount - reserved - spent - debt - Use for: period rollovers, plan changes
REPAY_DEBT: - debt -= amount (use remaining if debt < amount) - Use for: manual debt reconciliation
IDEMPOTENCY: - Required idempotency_key prevents double-funding - Replayed requests return original response
Authorizations
Tenant-scoped API key for runtime operations (consistent with Cycles Protocol)
Parameters
Path Parameters
"USD_MICROCENTS""TOKENS""CREDITS""RISK_POINTS"Request Body
Responses
Funding operation completed