Skip to main content
POST
Resume a fine-tuning job

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Headers

x-tenant-id
string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1
x-organization-id
string

Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.

Minimum string length: 1

Path Parameters

jobId
string<uuid>
required

Fine-tuning job id.

Response

OK

attempt
integer<int64>
required
read-only

The job's current attempt. A run that crashed or stopped restarts as the next attempt from its latest checkpoint, and so does a resumed job.

Required range: 1 <= x <= 9007199254740991
completedAt
null | string<date-time>
required
read-only

When the job last settled (succeeded, failed or cancelled); null while it is queued or running, including after a resume.

createdAt
string<date-time>
required
read-only
dataset
string
required
datasetProvenance
object
required
read-only

The dataset revision and split recorded when the job was created.

failure
object | null
required
read-only

Why the job failed; null unless status is failed.

jobId
string<uuid>
required
read-only
latestCheckpoint
object | null
required
read-only

The checkpoint at the highest step; null before the first is saved. The checkpoints collection lists them all.

model
string
required
name
string
required

The run's display name.

Required string length: 1 - 120
progress
object
required
read-only
result
object
required
read-only

What the job produced: its final checkpoint, set only once the job succeeds; an evaluation-only job never has one. Intermediate checkpoints are in latestCheckpoint and the checkpoints collection.

settings
object
required

The run settings the job trains with.

startedAt
null | string<date-time>
required
read-only

When a worker started the job; null while it is queued.

status
enum<string>
required
read-only

queued until a worker first starts it; a restarted or resumed job is running with progress.phase queued while it waits for a worker. succeeded is final; failed and cancelled are settled, and managedAgentsResumeFineTuningJob runs them again from their latest checkpoint, or from the beginning when they saved none.

Available options:
queued,
running,
succeeded,
failed,
cancelled
summary
object
required
read-only

Scores derived from the job's metrics, and the cost Tinker reports for the job.

updatedAt
string<date-time>
required
read-only