Skip to content
Qualia Docs

Start a durable byte-stable LeRobot materialization

POST
/v1/datasets/versions/materialize
 
curl --request POST \
  --url 'https://example.com/v1/datasets/versions/materialize?version_id=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0&output_format=lerobot_v3'

Create or recover a fenced background materialization operation.

This request never waits for cold rendering. Poll the exact returned materialization identity; once published, the operation carries immutable manifests plus fresh object-store/browser capabilities.

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
version_id
required

Dataset version id

string format: uuid

Dataset version id

output_format

Bundle layout to render

string
default: lerobot_v3
Allowed values: lerobot_v3 lerobot_v2_1

Bundle layout to render

account_id

Act on this account (active)

string | null format: uuid

Act on this account (active)

Header Parameters

Section titled “Header Parameters ”
x-api-key
string | null

Responses

Section titled “ Responses ”

202

Section titled “202 ”

Successful Response

Media type application/json
DatasetMaterializationOperationResponse

Durable async operation; payload metadata exists only when published.

object
materialization_id
required
string
/^[0-9a-f]{64}$/
version_id
required
string format: uuid
dataset_definition_id
required
string format: uuid
toolchain_revision_id
required
string
/^[0-9a-f]{64}$/
state
required
string
Allowed values: running published retryable
retry_after_ms
required
integer
<= 3600000
result
object
bundle_id
required
string
/^blake3:[0-9a-f]{64}$/
version
required
string
Allowed values: lerobot-v3 lerobot-v2.1
dataset_definition_id
required
string format: uuid
version_id
required
string format: uuid
episode_count
required
integer
total_frames
required
integer
format
required
string
Allowed value: directory
materialization_id
required
string
/^[0-9a-f]{64}$/
toolchain_revision_id
required
string
/^[0-9a-f]{64}$/
output_root
required
string
/^[0-9a-f]{64}$/
reused
required
boolean
artifact_count
required
integer
>= 1 <= 1000000
error_code
string | null
>= 1 characters <= 128 characters
error_message
string | null
>= 1 characters <= 4096 characters
Example 
{
  "state": "running",
  "result": {
    "version": "lerobot-v3",
    "format": "directory"
  }
}

422

Section titled “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": {}
    }
  ]
}