Skip to main content
GET
List a fine-tuning job's rollouts

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.

Query Parameters

split
enum<string>

Only rollouts of this split.

Available options:
train,
eval
step
integer<int64>

Only rollouts of this step. Needs split.

Required range: 0 <= x <= 9007199254740991
status
enum<string>

Only rollouts in this status. Needs split and step.

Available options:
queued,
running,
done,
failed
updatedAtGte
string<date-time>

Only rollouts changed at or after this time, oldest change first. Pass the largest updatedAt already read to poll for changes; rollouts changed at exactly that time are returned again.

limit
integer
default:200

Maximum rollouts to return.

Required range: 1 <= x <= 1000
cursor
string

Opaque cursor from nextCursor. Pass it unchanged with the same filters and limit.

Response

OK

items
object[]
required

Rollouts by split, step, group and sample; with updatedAtGte, by change time first.

nextCursor
null | string
required

Opaque continuation cursor, or null when no more rollouts match now.

total
null | integer
required

Always null; read until nextCursor is null.

Required range: 0 <= x <= 9007199254740991