jobs

Reserve job from quote (quote owner)

Atomically holds budget, reserves machine, increments fence and queues start. Rejects expired quote (409 QUOTE_EXPIRED), changed manifest, unavailable or not admitted machine, or insufficient spendable funds (409 INSUFFICIENT_FUNDS) without partial holds. Replaying the same Idempotency-Key with the same body returns the original job, so a timed-out request is safe to retry; the same key with another body is 409 IDEMPOTENCY_CONFLICT and reserves nothing.

post/api/v1/jobs

Request

  • Base URL: https://amplerun-api.spiry.org
  • URL: https://amplerun-api.spiry.org/api/v1/jobs
  • Auth: HTTP bearer

Headers

Idempotency-Keystring uuid required
Example:3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40

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

Request body

quote_idstring uuid required
ssh_public_keystring

One-line OpenSSH public key installed for the tenant user. Optional: without it the server installs a generated key whose private half it discards, so SSH is off for that rental (model rentals chat through /jobs/{id}/openai/v1).

Example request

{
  "quote_id": "3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40"
}

Response

Job reserved.

job_idstring uuid required
state'RESERVED' required

Example response

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

Changes

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