Skip to main content
POST
Create a fine-tuning job

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string
required

Replay-protection key in an organization-wide namespace shared by keyed mutations. It must contain 1 to 256 visible ASCII characters and be sent as exactly one header value. Request identity is the exact HTTP method, escaped path, raw query, and raw body bytes. The same request replays the original successful response; any different request returns 409 idempotency_conflict, and an active matching request returns 409 idempotency_in_progress. Completed receipts are retained for approximately 24 hours, pending claims may be reclaimed after approximately 1 hour, and no deduplication is guaranteed after expiry.

Required string length: 1 - 256
Pattern: ^[!-~]+$
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

Body

application/json
dataset
enum<string>
required

The dataset to train and evaluate on.

Available options:
automationbench-public-600
model
enum<string>
required

The base model to tune.

Available options:
thinkingmachines/Inkling-2-Small,
nvidia/NVIDIA-Nemotron-3.5-Lightning-30B-A3B-BF16,
nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-BF16
settings
object

Run settings. Each is validated against fixed bounds, and an omitted setting takes its default: two steps of four groups of four rollouts on the quick train tasks, evaluated after every step on the quick held-out tasks.

Response

Created

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

When the job reached a final status; null until then.

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
model
string
required
progress
object
required
read-only
result
object
required
read-only

What the job produced. Both fields are null until the trainer saves a checkpoint; an evaluation-only job never has one.

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 starts it; succeeded, failed and cancelled are final.

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

Scores derived from the job's metrics.

updatedAt
string<date-time>
required
read-only