Skip to main content
POST
Complete and validate a dataset import

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}$
importId
string<uuid>
required

Response

The upload is complete. Validation and dataset creation are queued.

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