Skip to content
Qualia Docs

Poll one exact durable materialization operation

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

Return status; published results mint fresh short-lived capabilities.

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
version_id
required

Dataset version id

string format: uuid

Dataset version id

materialization_id
required

Exact materialization identity

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

Exact materialization identity

toolchain_revision_id
required

Exact toolchain revision

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

Exact toolchain revision

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 ”

200

Section titled “200 ”

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