List versions for a dataset
GET
/v1/datasets/{datasetId}/versionscurl -X GET 'https://api.embodiflow.io/v1/datasets/{datasetId}/versions' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT'Authorization
Send a personal access token with every request.
- Authorization: Bearer PAT
Path parameters
- datasetIdstringrequired
Query parameters
- pageSizenumber
Page size (default 25, maximum 100). Over-maximum is refused.
- pageTokenstring
Opaque page token from the previous response.
- sortBystring
- sortOrderstringAllowed valuesascdesc
- statusstring
- metadataTypestring
- codebaseVersionstring
- fpsMinnumber
- fpsMaxnumber
- startTimeNsMinnumber
- startTimeNsMaxnumber
- endTimeNsMinnumber
- endTimeNsMaxnumber
- metadataKeystring
- metadataEqualsstring
- includeSoftHiddenboolean
When true, include versions with visibilityStatus soft_hidden (default list excludes them).
- qstring
Case-insensitive search over versionName, description, and version number (vN / N).
Responses
Success
- dataarray<DatasetVersionSummaryDto>required
- idstringrequired
- datasetIdstringrequired
- versionnumberrequired
- versionNamestring | nullrequired
- descriptionstring | nullrequired
- statusstringrequired
- manifestVersionnumber
- metadataTypestring | null
- codebaseVersionstring | null
- episodeCountnumber | null
- lerobotEpisodeCountnumber | null
- featureCountnumber | null
- fpsnumber | null
- topicCountnumber | null
- frameCountnumber | null
- startTimeNsnumber | null
- endTimeNsnumber | null
- metadataProjectionJsonobject | null
- contractVersionstring | null
- provenanceCompletenessstring | nullAllowed valuesmissingpartialcomplete
- featureKeysarray<string> | null
- itemCountnumberrequired
- totalBytesnumber | nullrequired
- finalizedAtstring | nullrequired
- createdAtstringrequired
- qualityStatusstringAllowed valuesfailedwarningerroruncheckedinspectingpassed
- visibilityStatusstringAllowed valuesactivesoft_hidden
- splitStrategystring | null
- splitConfigJsonobject | null
- operationFactsobject
- metaobjectrequired
- pageSizenumberrequired
- requestIdstring
- nextPageTokenstring
Opaque AIP-158 page token. Omitted when the collection is exhausted.
Response example
{
"data": [
{
"id": "string",
"datasetId": "string",
"version": 0,
"versionName": "string",
"description": "string",
"status": "string",
"manifestVersion": 0,
"metadataType": "string",
"codebaseVersion": "string",
"episodeCount": 0,
"lerobotEpisodeCount": 0,
"featureCount": 0,
"fps": 0,
"topicCount": 0,
"frameCount": 0,
"startTimeNs": 0,
"endTimeNs": 0,
"metadataProjectionJson": {},
"contractVersion": "string",
"provenanceCompleteness": "missing",
"featureKeys": [
"string"
],
"itemCount": 0,
"totalBytes": 0,
"finalizedAt": "string",
"createdAt": "string",
"qualityStatus": "failed",
"visibilityStatus": "active",
"splitStrategy": "string",
"splitConfigJson": {},
"operationFacts": {
"contractVersion": "embodiflow-recording-operation-facts/v1",
"observedAt": "string",
"processing": {
"anyActive": false,
"upload": {
"activeCount": 0,
"status": "string",
"uploadBatchId": "string"
},
"workflow": {
"activeCount": 0,
"status": "queued",
"workflowRunId": "string"
},
"quality": {
"activeCount": 0,
"status": "failed",
"workflowRunId": "string"
}
},
"health": {
"status": "unknown",
"primaryBlockerCode": "string",
"openRepairCount": 0,
"observedAt": "string",
"stale": false
},
"playback": {
"artifactAvailable": false,
"reasonCode": "string"
},
"lastMeaningfulActivityAt": "string"
}
}
],
"meta": {
"pageSize": 0,
"requestId": "string"
},
"nextPageToken": "string"
}Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1