List items for a version

GET

/v1/datasets/{datasetId}/versions/{versionId}/items

curl -X GET 'https://api.embodiflow.io/v1/datasets/{datasetId}/versions/{versionId}/items' \
  -H 'Authorization: Bearer $EMBODIFLOW_PAT'

Authorization

Send a personal access token with every request.

Authorization: Bearer PAT

Authentication guide

Path parameters

datasetIdstringrequired
versionIdstringrequired

Query parameters

pageSizenumber
Page size (default 25, maximum 100). Over-maximum is refused.
pageTokenstring
Opaque page token from the previous response.
sortBystring
sortOrderstring
Allowed values
asc
desc
splitstring
episodeIndexnumber
includeExcludedboolean
ADR 0157 W6 — explicit opt-in to include training-excluded episodes.

Responses

Success

dataarray<DatasetVersionItemSummaryDto>required
- idstringrequired
- datasetVersionIdstringrequired
- datasetVersionFileIdstring | nullrequired
- sampleKeystringrequired
- episodeIndexnumber | nullrequired
- splitstringrequired
  Allowed values
  test
  val
  train
  unset
- taskstring | nullrequired
- successone of | nullrequired
- durationNsnumber | nullrequired
- frameCountnumber | nullrequired
- actionCountnumber | nullrequired
- provenanceJsonobject | nullrequired
- sourceFileIdsarray<string> | nullrequired
- annotationCountnumberrequired
- metadataobject | nullrequired
- createdAtstringrequired
- qualityStatusstring | null
- excludedFromTrainingone of
- excludedReasonstring | null
metaobjectrequired
- pageSizenumberrequired
- requestIdstring
nextPageTokenstring
Opaque AIP-158 page token. Omitted when the collection is exhausted.

Response example

{
  "data": [
    {
      "id": "string",
      "datasetVersionId": "string",
      "datasetVersionFileId": "string",
      "sampleKey": "string",
      "episodeIndex": 0,
      "split": "test",
      "task": "string",
      "success": false,
      "durationNs": 0,
      "frameCount": 0,
      "actionCount": 0,
      "provenanceJson": {},
      "sourceFileIds": [
        "string"
      ],
      "annotationCount": 0,
      "metadata": {},
      "createdAt": "string",
      "qualityStatus": "string",
      "excludedFromTraining": false,
      "excludedReason": "string"
    }
  ],
  "meta": {
    "pageSize": 0,
    "requestId": "string"
  },
  "nextPageToken": "string"
}

Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1

{ "data": [ { "id": "string", "datasetVersionId": "string", "datasetVersionFileId": "string", "sampleKey": "string", "episodeIndex": 0, "split": "test", "task": "string", "success": false, "durationNs": 0, "frameCount": 0, "actionCount": 0, "provenanceJson": {}, "sourceFileIds": [ "string" ], "annotationCount": 0, "metadata": {}, "createdAt": "string", "qualityStatus": "string", "excludedFromTraining": false, "excludedReason": "string" } ], "meta": { "pageSize": 0, "requestId": "string" }, "nextPageToken": "string" }