Effects

Cap what one unit of agent work may spend

Opens or adjusts a wallet for a run id. The gate refuses any effect that would carry the run past this total — before the money moves, which is the only moment refusing is still cheap. Unlike the daily budgets this never resets: a task is not a day. Lowering a limit below what is already spent claws nothing back; it means nothing further may be spent. Counts what callers declare in estimated_cost_micros, so it is only ever as good as what they declare.

put/v1/runs/{runId}/budget

Request

  • Base URL: https://ratchetgate.com
  • URL: https://ratchetgate.com/v1/runs/{runId}/budget
  • Auth: HTTP bearer

Path parameters

runIdstring required

Request body

limit_microsinteger required

Total this run may spend at vendors, in micro-USD. 1000000 = $1.

Response

Default Response

object required

Changes

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