budget-guard

budget status

See spend vs limits, remaining budget, whether the run is stopped and why, and the last 20 ledger events. Set close=true when the run finishes.

post/api/v1/budget-guard/budget_status

Request

  • Base URL: https://cloudforbots.com
  • URL: https://cloudforbots.com/api/v1/budget-guard/budget_status
  • 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.

closeboolean

Response

Tool result (always includes request_id).

object required

Changes

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