Skip to main content
POST
Create Dataset Import

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Which repository to copy, and where to put it.

ref
string
required

The repository, as hf:namespace/name[@revision] or ms:namespace/name[@revision]. A reference with no hub prefix names a platform dataset and is refused -- there is nothing to import.

name
string
required

Destination dataset name.

selection
HFSelection · object | null

Optional HF config/split selection of original Parquet or JSONL shards.

owner
string
default:""

Destination owner. Defaults to the requester; writing under somebody else's namespace follows the registry's own rule.

Response

Successful Response

id
integer
required
hub
string
required
kind
string
required
repo_id
string
required
ref
string
required
dataset
string
required
dest_owner
string
required
dest_name
string
required
status
string
required
requested_by
string
required
selection
HFSelection · object | null
revision
string
default:""
resolved
string
default:""
dest_version
string
default:""
files
integer
default:0
bytes
integer
default:0
error
string
default:""
created_at
string | null
started_at
string | null
finished_at
string | null