Get Finetune Status

GET

/v1/finetune/{job_id}

curl --request GET \
  --url https://example.com/v1/finetune/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0

Get the status of a finetune job from the pipeline API.

Parameters

Path Parameters

job_id

required

string format: uuid

Header Parameters

x-api-key

string | null

Responses

200

Job status retrieved successfully

Media type application/json

FinetuneStatusResponse

Detailed status of a finetune job.

object

job_id

required

Unique job identifier

string format: uuid

project_id

Project associated with the training run

string | null format: uuid

current_phase

required

Current phase name

string

status

required

Overall job status: queued, scheduled, running, completed, failed, cancelled

string

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

phases

Phase history in chronological order

Array<object>

Phase

A training phase with its events.

object

name

required

Phase name

string

status

required

Phase status: pending, queued, in_progress, completed, failed

string

started_at

When phase started

string | null format: date-time

completed_at

When phase completed

string | null format: date-time

events

Events in this phase

Array<object>

PhaseEvent

A single event within a phase.

object

status

required

Event status: started, completed, failed

string | null

message

Event message

string | null

error

Error details if failed

string | null

timestamp

required

Event timestamp

string format: date-time

retry_attempt

Retry attempt number

integer

0

data

Additional event data

object

key

additional properties

any

error

Error message if phase failed

string | null

telemetry

Training telemetry points (loss, gradient norm, learning rate, …) recorded so far, oldest first. Replayed from persisted events so a page load reconstructs the full series without the live SSE stream.

Array<object>

object

key

additional properties

any

Example

{
  "metadata": {
    "vla_type": "act",
    "job_type": "vla",
    "use_rabc": false
  },
  "phases": [
    {
      "events": [
        {
          "retry_attempt": 0
        }
      ]
    }
  ]
}

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"
}

404

Finetune job not found

Media type application/json

ErrorResponse

Standard error response.

object

detail

required

Error message describing what went wrong

string

Example ^generated

{
  "detail": "example"
}

422

Validation error