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'认证
每个请求都需要携带个人访问令牌（PAT）。
- Authorization: Bearer PAT
路径参数
- datasetIdstring必填
查询参数
- pageSizenumber
Page size (default 25, maximum 100). Over-maximum is refused.
- pageTokenstring
Opaque page token from the previous response.
- sortBystring
- sortOrderstring可选值ascdesc
- 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).
响应
Success
- dataarray<DatasetVersionSummaryDto>必填
- idstring必填
- datasetIdstring必填
- versionnumber必填
- versionNamestring | null必填
- descriptionstring | null必填
- statusstring必填
- 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 | null可选值missingpartialcomplete
- featureKeysarray<string> | null
- itemCountnumber必填
- totalBytesnumber | null必填
- finalizedAtstring | null必填
- createdAtstring必填
- qualityStatusstring可选值failedwarningerroruncheckedinspectingpassed
- visibilityStatusstring可选值activesoft_hidden
- splitStrategystring | null
- splitConfigJsonobject | null
- operationFactsobject
- metaobject必填
- pageSizenumber必填
- requestIdstring
- nextPageTokenstring
Opaque AIP-158 page token. Omitted when the collection is exhausted.
响应示例
{
"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"
}服务器https://api.embodiflow.io/v1https://api.embodiflow.dev/v1