Extend Job Budget V1
Raise max_cost_usd on a live job at runtime. Tenants reach for this when a job is mid-flight and approaching its original cap — they’d rather pay another…
POST
Raise
max_cost_usd on a live job at runtime.
Tenants reach for this when a job is mid-flight and approaching its
original cap — they’d rather pay another dollar than have it
cancel + lose progress. The new cap is written to params.max_cost_usd
and observed by the worker on its next iteration’s cost-cap check.
Only live jobs (queued / running / awaiting_approval) can be
extended — terminal jobs return 409. Strictly raise-only: the
requested cap must be greater than the current one.
Path parameters
string (uuid)
required
Request body
ExtendBudgetRequest
number
required
New cap, USD. Must be strictly higher than the current cap (or set when the job had none). Lowering is rejected with 409 because dropping the cap below the running cost would trip an immediate self-cancellation, which is what tenants are usually trying to avoid by calling this.
Response
ExtendBudgetResponse
string
required
number,null
required
number
required
number
required