jobs

Append funded budget amendment (renter owner)

Idempotent. Appends one immutable amendment plus hold atomically; keeps original rate and snapshotted host-availability ceiling; bumps budget_version. Rejects once STOPPING begins. D-16 — budget_version changes only with a committed funding amendment.

post/api/v1/jobs/{id}/budget-extension

Request

Base URL: https://amplerun-api.spiry.org
URL: https://amplerun-api.spiry.org/api/v1/jobs/{id}/budget-extension
Auth: HTTP bearer

Path parameters

idstring uuid required

Example:3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40

Headers

Idempotency-Keystring uuid required

Example:3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40

UUID scoped to authenticated principal, route and canonical request hash.

Request body

additional_budget_microstring required

Unsigned base-10 integer as string; never a float.

new_duration_limit_sinteger required

expected_job_versionstring required

Unsigned base-10 integer as string; never a float.

expected_budget_versionstring required

Unsigned base-10 integer as string; never a float.

Example request

{
  "additional_budget_micro": "1",
  "expected_job_version": "1",
  "expected_budget_version": "1"
}

Response

Amendment committed; returns new budget_version.

job_idstring uuid required

budget_versionstring required

Unsigned base-10 integer as string; never a float.

funded_budget_microstring required

Unsigned base-10 integer as string; never a float.

Example response

{
  "job_id": "3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40",
  "budget_version": "1",
  "funded_budget_micro": "1"
}

Changes

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