List Jobs (Paginated)

GET

/v1/jobs/list

curl --request GET \
  --url 'https://example.com/v1/jobs/list?limit=20&sort=newest'

List pipeline runs for the current account.

Parameters

Query Parameters

project_id

Filter by project

string | null format: uuid

Filter by project

vla_type

Filter by VLA type

string | null

Filter by VLA type

job_type

Filter: vla, reward, vla_w_reward

string | null

Filter: vla, reward, vla_w_reward

search

Search job description, model, or dataset

string | null

<= 200 characters

Search job description, model, or dataset

account_id

Scope to this account (the dashboard’s active account). Membership is verified upstream; a non-member gets 403.

string | null format: uuid

Scope to this account (the dashboard’s active account). Membership is verified upstream; a non-member gets 403.

limit

integer

default: 20 >= 1 <= 100

cursor

Pagination cursor

string | null

Pagination cursor

sort

string

default: newest

Allowed values: newest oldest updated

Header Parameters

x-api-key

string | null

Responses

200

Paginated list of training jobs

Media type application/json

PaginatedJobsResponse

object

items

Array<object>

JobItem

object

job_id

required

string format: uuid

project_id

required

string format: uuid

status

Latest phase status

string | null

current_phase

Latest phase name

string | null

metadata

FinetunePublicMetadata

Fixed public projection of durable pipeline inputs.

Storage locations, read capabilities, internal principals, compute overrides, and the raw run snapshot are deliberately not representable.

object

job_desc

string | null

<= 1024 characters

vla_type

string

Allowed values: act smolvla pi05 sarm

job_type

string

Allowed values: vla reward vla_w_reward

model_name

string | null

<= 193 characters

dataset_version_id

string | null format: uuid

base_model

object

hub_id

required

string

>= 3 characters <= 193 characters

revision

required

string

/^[0-9a-f]{40}$/

reward_model

object

hub_id

required

string

>= 3 characters <= 193 characters

revision

required

string

/^[0-9a-f]{40}$/

use_rabc

boolean

training_hours

number | null

> 0 <= 168

batch_size

integer | null

>= 1 <= 512

instance_type

string | null

<= 128 characters

region

string | null

<= 128 characters

created_at

string | null format: date-time

finetuned_model_id

string | null

page_info

required

PageInfo

object

has_next

required

Whether more items exist after this page

boolean

end_cursor

Cursor for the next page

string | null

total_count

Total matching items

integer | null

Example

{
  "items": [
    {
      "metadata": {
        "vla_type": "act",
        "job_type": "vla",
        "use_rabc": false
      }
    }
  ]
}

401

Invalid or missing API key

Media type application/json

ErrorResponse

Standard error response.

object

detail

required

Error message describing what went wrong

string

Example ^generated

{
  "detail": "example"
}

422

Invalid pagination parameters