Skip to main content
POST
Create a dataset import session

Authorizations

Authorization
string
header
required

A W&B API key.

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}$

Body

application/json
idempotency_key
string
required
Required string length: 1 - 128
name
string
required
Required string length: 1 - 128
file
object
required
split_policy
object
required
duplicate_policy
object

Response

Durable multipart upload session.

id
string<uuid>
required
task_id
string<uuid>
required
dataset_id
string<uuid> | null
required

Destination dataset ID, assigned when dataset creation begins. Wait for state ready before using the dataset. Null before creation or after the dataset is deleted.

name
string
required
split_policy
object
required

The split policy accepted when the import was created.

duplicate_policy
object
required

The duplicate policy accepted when the import was created.

state
enum<string>
required
Available options:
uploading,
queued,
validating,
auditing,
committing,
ready,
failed,
cancelled,
expired
total_bytes
integer
required
Required range: x >= 1
counters
object | null
required

Validation totals when available; otherwise null.

error
string | null
required
expires_at
string<date-time>
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
file
object
required
validation
object
required
Last modified on September 21, 2026