budget-guard

record

After a call, report the actual usage minus what you reserved (positive if it cost more, negative to give back an overestimate). Keeps the ledger honest without blocking.

post/api/v1/budget-guard/record

Request

  • Base URL: https://cloudforbots.com
  • URL: https://cloudforbots.com/api/v1/budget-guard/record
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Makes the call safe to retry; the same key returns the stored reply for 24h.

X-Request-Idstring

Request body

handlestring required

The budget handle from open_budget (looks like bg_<id>.<secret>). Pass it to every sub-agent so they all spend from the same budget.

usdnumber
tokensinteger
notestring

Response

Tool result (always includes request_id).

object required

Changes

No recorded changes to this operation across all 1 revision of this API.