Skip to main content
POST
Start a JSONL upload into a dataset

Authorizations

Authorization
string
header
required

A wandb API key or wandb JWT. Browser sessions are exchanged by the Model Distillation web app backend; job capabilities are internal only.

Headers

Wandb-Entity
string

Accessible personal or team entity. Omit to use the authenticated user's default entity.

Path Parameters

alias
string
required
Pattern: ^[a-z0-9-]{1,64}$
datasetId
string<uuid>
required

Body

application/json
idempotency_key
string
required

Repeating a request with the same key returns the same upload.

Required string length: 1 - 128
file
object
required
mode
enum<string>
default:append

append rejects rows whose row_id already exists; upsert replaces them.

Available options:
append,
upsert

Response

The upload session.

id
string<uuid>
required
dataset_id
string<uuid>
required
mode
enum<string>
required
Available options:
append,
upsert
state
enum<string>
required

uploading until complete is called; queued and validating while the worker checks every line; committed once the rows are in the dataset.

Available options:
uploading,
queued,
validating,
committed,
failed,
cancelled,
expired
error
string | null
required
counters
object | null
required

After commit: rows, created, updated, revision, and entry_counts.

expires_at
string<date-time>
required
file
object
required
upload
object | null
required

Where to send the file while the upload is open; null once complete is called.

validation
object
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
Last modified on October 7, 2026