OSos3robotics
jobs

Get Job

The job, with the GPU-hours it has used so far and their cost at the list price: what was billed once it has ended, else what would be billed if it ended now.

get/jobs/{job_id}

Request

  • Base URL
    https://api.os3robotics.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.os3robotics.com/jobs/{job_id}
  • Auth
    • HTTP bearer
    • or HTTP bearer

Path parameters

job_idstring uuid required

Response

Successful Response

idstring uuid required
tenant_idstring uuid required
workspace_idstring uuid required
numberinteger required
dataset_version_idstring uuid required
image_digeststring required
state'queued' | 'provisioning' | 'running' | 'evaluating' | 'succeeded' | 'failed' | 'cancelled' required
agent_stepinteger required
attemptinteger required
errorstring nullable required
idempotency_keystring required
cancel_requested_atstring date-time nullable required
cancel_reasonstring nullable
queued_atstring date-time required
provisioning_atstring date-time nullable required
running_atstring date-time nullable required
finished_atstring date-time nullable required
pull_snumber nullable required
start_snumber nullable required
compile_snumber nullable required
runs_onstring[] nullable
waitingstring nullable
env_revision_idstring uuid nullable

An RL training job's environment revision: the exact revision of the environment catalog it trains in, qualified for training when the job was made.

fanout_idstring uuid nullable
allocation_idstring uuid nullable

The shared allocation the job trains in (a shared_lora fan-out): the job that holds its GPUs, whose logs show the allocation's own lines; null for a job with GPUs of its own.

pipeline_defaultsobject nullable
gpu_hoursstring required

GPU-hours used so far: run time times GPU count

cost_usd_so_farstring required

The GPU time used so far at the list price per normalised H100-hour, as the estimate's cost_usd

usage_status'unreported' | 'provisional' | 'recorded' required

Whether usage is not yet reported, a running estimate, or recorded in the usage ledger. Recorded list-price usage is not the customer's final charge.

Changes

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