Skip to main content
POST
Upload rows to a dataset

Authorizations

Authorization
string
header
required

Create an API key in the console. Required when accounts are enabled.

Headers

x-max-price-usd
string | null
x-family
string | null

The family whose page adds these rows, such as router: one of your families on this dataset. The version records it, so the family can say where its new data came from.

Pattern: ^[a-z](?:-?[a-z0-9]){1,62}$
idempotency-key
string | null

Path Parameters

dataset_id
string
required

Body

One JSON object per line, or a CSV whose first line is context and some of the dataset's decision ids, and whose cells name each decision's right outcome.

The body is of type string.

Response

Successful Response

id
string
required
name
string
required
created_at
number
required
sha256
string
required

Names every row of the latest version: its first version's file digest, each later one's chained on.

version
integer
required

The latest version. Counts and the split are this version's.

status
string
required
Allowed value: "validated"
rows
integer
required
contexts
integer
required
duplicates_removed
integer
required
method
enum<string>
required
Available options:
sft,
reward
augmentation
string
required
Allowed value: "none"
archived_at
number | null
required

When we archived it: when credit couldn't cover its storage, or on a suspension. Restore it to start new work. Null in the library.

evaluation_only
boolean
required
evaluation_fraction
number
required
split
Split · object
required
prompt_tuning
PromptTuningReadiness · object

What prompt tuning can tune in the training partition, worked out when the dataset was made. Datasets of outcome scores have none.

input
InputReceipt · object
labeling
LabelingLineage · object
storage_window
StorageWindow · object | null

The day of storage held now, at the price it was accepted at, or null. Archiving or deleting it charges the minutes used of it; later days are priced as they start.

labels_to_check
integer

How many labels prompt tuning doubted in this dataset that nobody has dismissed, each row and decision once, as its labels-to-check route lists them.