OSos3robotics
jobs

List Jobs

Newest first; a full page sets X-Next-After (its last job's id), which after takes, and X-Total-Count is how many jobs the filters match. Filters: ref (repeatable) the jobs it names, by their id or by the model or adapter version they registered; state (repeatable) those in these states; waiting those waiting for capacity, or not; kind those that train a robot policy, or an LLM adapter (an LoRA, RFT or RLVR run); fanout those started in a fan-out, or not; base and base_model those of that base (an LLM run's base model); dataset_id those trained on a version of that dataset; q those whose name ("<dataset name> v<number>") or dataset version ("<dataset name> v<version>") holds it, case aside; since those queued at or after that time.

get/jobs

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
  • Auth
    • HTTP bearer
    • or HTTP bearer

Query parameters

workspace_idstring uuid nullable
limitinteger
afterstring uuid nullable
refstring[] nullable
stateJobState[] nullable
waitingboolean nullable
kind'policy' | 'adapter' nullable
fanoutboolean nullable
basestring nullable
base_modelstring nullable
dataset_idstring uuid nullable
sincestring date-time nullable
qstring nullable

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

Changes

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