List studio for a dataset

GET

/v1/datasets/{datasetId}/studio

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

Authorization

Send a personal access token with every request.

Authorization: Bearer PAT

Authentication guide

Path parameters

datasetIdstringrequired

Query parameters

datasetVersionIdstring (uuid)

Responses

Success

dataobjectrequired
- datasetobjectrequired
- projectIdstringrequired
- projectTypestringrequired
- projectNamestringrequired
- currentDatasetVersionIdstring | nullrequired
- capabilitiesobjectrequired
- videosarray<DatasetStudioVideoTrackDto>required
- studioMessagestring | nullrequired
- draftSummaryobjectrequired
- timeRangeAnnotationsarray<DatasetTimeRangeAnnotationDto>required
- frameSpatialAnnotationsarray<DatasetFrameSpatialAnnotationDto>required

Response example

{
  "data": {
    "dataset": {
      "id": "string",
      "tenantId": "string",
      "projectId": "string",
      "slug": "string",
      "name": "string",
      "description": "string",
      "datasetType": "string",
      "sourceType": "string",
      "dataSource": "string",
      "consentAttested": false,
      "canAttestConsent": false,
      "metadataSchema": "string",
      "status": "string",
      "currentVersionId": "string",
      "versionCount": 0,
      "currentVersion": {
        "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": {
            "upload": {},
            "workflow": {},
            "quality": {}
          },
          "health": {
            "status": "unknown",
            "primaryBlockerCode": "string",
            "openRepairCount": 0,
            "observedAt": "string"
          },
          "playback": {
            "reasonCode": "string"
          },
          "lastMeaningfulActivityAt": "string"
        }
      },
      "qualityStatus": "failed",
      "lastQualityInspectionAt": "string",
      "recordingStatus": {
        "lifecycle": "failed",
        "quality": "warn",
        "qualityCheckId": "string",
        "qualityVerdict": "warning",
        "stepId": "string",
        "stepWaitReason": "string",
        "noProgressSince": "string",
        "failure": {
          "code": "string",
          "reason": "string",
          "stepId": "string",
          "stepName": "string",
          "stepAlgorithm": {
            "slug": "string",
            "title": "string"
          },
          "stepRunId": "string",
          "runId": "string",
          "stepErrorCode": "string"
        },
        "runId": "string",
        "processingRefused": {
          "code": "string"
        }
      },
      "updatedAt": "string",
      "createdAt": "string"
    },
    "projectId": "string",
    "projectType": "string",
    "projectName": "string",
    "currentDatasetVersionId": "string",
    "capabilities": {
      "supportsVideoStudio": false,
      "supportsAnnotationDrafts": false,
      "supportsSnapshotPublish": false
    },
    "videos": [
      {
        "datasetVersionFileId": "string",
        "datasetVersionId": "string",
        "logicalPath": "string",
        "contentType": "string",
        "sizeBytes": 0,
        "channelName": "string",
        "sensorName": "string",
        "sequenceIndex": 0,
        "playUrl": "string",
        "playUrlExpiresAt": "string",
        "presignError": "string",
        "lightIndex": {
          "durationSec": 0,
          "width": 0,
          "height": 0,
          "fps": 0,
          "codec": "string",
          "container": "string",
          "thumbnailObjectId": "string",
          "timeOffsetMs": 0
        }
      }
    ],
    "studioMessage": "string",
    "draftSummary": {
      "timeRangeAnnotationCount": 0,
      "frameSpatialAnnotationCount": 0
    },
    "timeRangeAnnotations": [
      {
        "id": "string",
        "tenantId": "string",
        "projectId": "string",
        "datasetId": "string",
        "datasetVersionId": "string",
        "annotationSchemaId": "string",
        "segmentKind": "string",
        "startSec": 0,
        "startNsec": 0,
        "endSec": 0,
        "endNsec": 0,
        "timeReference": "string",
        "title": "string",
        "naturalLanguageInstruction": "string",
        "success": false,
        "score": 0,
        "failureReason": "string",
        "parentId": "string",
        "orderIndex": 0,
        "reviewStatus": "string",
        "status": "string",
        "publishedSnapshotId": "string",
        "createdBy": "string",
        "updatedBy": "string",
        "createdAt": "string",
        "updatedAt": "string",
        "deletedAt": "string",
        "attributesJson": {}
      }
    ],
    "frameSpatialAnnotations": [
      {
        "id": "string",
        "tenantId": "string",
        "projectId": "string",
        "datasetId": "string",
        "datasetVersionId": "string",
        "datasetVersionFileId": "string",
        "frameIndex": 0,
        "frameStampSec": 0,
        "frameStampNsec": 0,
        "timeReference": "string",
        "datasetClassId": "string",
        "className": "string",
        "trackId": "string",
        "trackKey": "string",
        "bboxX": 0,
        "bboxY": 0,
        "bboxWidth": 0,
        "bboxHeight": 0,
        "occluded": false,
        "truncated": false,
        "reviewStatus": "string",
        "status": "string",
        "publishedSnapshotId": "string",
        "createdBy": "string",
        "updatedBy": "string",
        "createdAt": "string",
        "updatedAt": "string",
        "deletedAt": "string",
        "attributesJson": {}
      }
    ]
  }
}

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

{ "data": { "dataset": { "id": "string", "tenantId": "string", "projectId": "string", "slug": "string", "name": "string", "description": "string", "datasetType": "string", "sourceType": "string", "dataSource": "string", "consentAttested": false, "canAttestConsent": false, "metadataSchema": "string", "status": "string", "currentVersionId": "string", "versionCount": 0, "currentVersion": { "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": { "upload": {}, "workflow": {}, "quality": {} }, "health": { "status": "unknown", "primaryBlockerCode": "string", "openRepairCount": 0, "observedAt": "string" }, "playback": { "reasonCode": "string" }, "lastMeaningfulActivityAt": "string" } }, "qualityStatus": "failed", "lastQualityInspectionAt": "string", "recordingStatus": { "lifecycle": "failed", "quality": "warn", "qualityCheckId": "string", "qualityVerdict": "warning", "stepId": "string", "stepWaitReason": "string", "noProgressSince": "string", "failure": { "code": "string", "reason": "string", "stepId": "string", "stepName": "string", "stepAlgorithm": { "slug": "string", "title": "string" }, "stepRunId": "string", "runId": "string", "stepErrorCode": "string" }, "runId": "string", "processingRefused": { "code": "string" } }, "updatedAt": "string", "createdAt": "string" }, "projectId": "string", "projectType": "string", "projectName": "string", "currentDatasetVersionId": "string", "capabilities": { "supportsVideoStudio": false, "supportsAnnotationDrafts": false, "supportsSnapshotPublish": false }, "videos": [ { "datasetVersionFileId": "string", "datasetVersionId": "string", "logicalPath": "string", "contentType": "string", "sizeBytes": 0, "channelName": "string", "sensorName": "string", "sequenceIndex": 0, "playUrl": "string", "playUrlExpiresAt": "string", "presignError": "string", "lightIndex": { "durationSec": 0, "width": 0, "height": 0, "fps": 0, "codec": "string", "container": "string", "thumbnailObjectId": "string", "timeOffsetMs": 0 } } ], "studioMessage": "string", "draftSummary": { "timeRangeAnnotationCount": 0, "frameSpatialAnnotationCount": 0 }, "timeRangeAnnotations": [ { "id": "string", "tenantId": "string", "projectId": "string", "datasetId": "string", "datasetVersionId": "string", "annotationSchemaId": "string", "segmentKind": "string", "startSec": 0, "startNsec": 0, "endSec": 0, "endNsec": 0, "timeReference": "string", "title": "string", "naturalLanguageInstruction": "string", "success": false, "score": 0, "failureReason": "string", "parentId": "string", "orderIndex": 0, "reviewStatus": "string", "status": "string", "publishedSnapshotId": "string", "createdBy": "string", "updatedBy": "string", "createdAt": "string", "updatedAt": "string", "deletedAt": "string", "attributesJson": {} } ], "frameSpatialAnnotations": [ { "id": "string", "tenantId": "string", "projectId": "string", "datasetId": "string", "datasetVersionId": "string", "datasetVersionFileId": "string", "frameIndex": 0, "frameStampSec": 0, "frameStampNsec": 0, "timeReference": "string", "datasetClassId": "string", "className": "string", "trackId": "string", "trackKey": "string", "bboxX": 0, "bboxY": 0, "bboxWidth": 0, "bboxHeight": 0, "occluded": false, "truncated": false, "reviewStatus": "string", "status": "string", "publishedSnapshotId": "string", "createdBy": "string", "updatedBy": "string", "createdAt": "string", "updatedAt": "string", "deletedAt": "string", "attributesJson": {} } ] } }