Import an exact Hugging Face dataset commit server-side

POST

/v1/datasets/import-hf

curl --request POST \
  --url https://example.com/v1/datasets/import-hf \
  --header 'Content-Type: application/json' \
  --data '{ "idempotency_key": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "repo_id": "example", "revision": "example", "name": "example", "source_format": "lerobot_v2_1", "hf_token": "example" }'

Dispatch one pinned source acquisition under this account.

The Modal QDS ingest worker inventories Hugging Face and streams bodies directly to R2. This route carries only source coordinates and the initial optional token; gateway and pipeline-api never proxy dataset bytes.

Parameters

Query Parameters

account_id

Act within this account (the dashboard’s active account).

string | null format: uuid

Act within this account (the dashboard’s active account).

Header Parameters

x-api-key

string | null

Request Body ^required

Media type application/json

HuggingFaceImportBody

Server-side import of one exact public Hugging Face dataset commit.

object

idempotency_key

required

string format: uuid

repo_id

required

string

>= 3 characters <= 200 characters /^[A-Za-z0-9][A-Za-z0-9._-]*/[A-Za-z0-9][A-Za-z0-9._-]*$/

revision

required

string

/^[0-9a-f]{40}$/

name

required

string

>= 1 characters <= 100 characters

source_format

required

string

Allowed values: lerobot_v2_1 lerobot_v3

hf_token

string | null

>= 1 characters <= 512 characters

Responses

202

Successful Response

Media type application/json

Example ^generated

example

422

Validation Error

Media type application/json

HTTPValidationError

object

detail

Array<object>

ValidationError

object

loc

required

Location

Array<string | integer>

msg

required

Message

string

type

required

Error Type

string

input

ctx

Context

object

Example ^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}