List recordings in a project

GET

/v1/projects/{projectId}/recordings

curl -X GET 'https://api.embodiflow.io/v1/projects/{projectId}/recordings' \
  -H 'Authorization: Bearer $EMBODIFLOW_PAT'

Authorization

Send a personal access token with every request.

Authorization: Bearer PAT

Authentication guide

Path parameters

projectIdstringrequired

Query parameters

pageSizenumber
Page size (default 25, maximum 100). Over-maximum is refused.
pageTokenstring
Opaque page token from the previous response.
qstring
lifecyclestring
Allowed values
empty
uploading
processing
ready
failed
stalled
privacyStatestring
Allowed values
pending
anonymized
refused
segmentationStatestring
Allowed values
not_segmented
proposed
reviewed
sourcestring
Allowed values
upload
collection
hub_import
collectorIdstring (uuid)
episodeCountMinnumber
episodeCountMaxnumber
episodeCountMaxExclusivenumber
uploadedAfterstring
uploadedBeforestring
selectionRunIdstring (uuid)

Responses

Success

dataarray<RecordingDto>required
- idstringrequired
- projectIdstringrequired
- namestringrequired
- tagsarray<string>required
- sourceFormatstring | nullrequired
- sourcestringrequired
  Allowed values
  upload
  collection
  hub_import
- huggingFaceobject
- statusobjectrequired
- segmentationStateobjectrequired
- privacyStatestring | nullrequired
  Allowed values
  pending
  anonymized
  refused
- privacyRequirementstring
  Allowed values
  required
  not_required
- privacyGatestring
  Allowed values
  human
  non_human
- durationNsnumber | nullrequired
- collectorany | nullrequired
- posterUrlstring | nullrequired
- latestReadyProcessingResultIdstring | nullrequired
- processedWithobject | nullrequired
- rigProfileobject | nullrequired
- captureLabelsobject
- rejectedSavedMinutesnumber | nullrequired
- createdAtstringrequired
- updatedAtstringrequired
nextPageTokenstring
Opaque AIP-158 page token. Omitted when the collection is exhausted.
metaobjectrequired
- pageSizenumberrequired
- requestIdstring

Response example

{
  "data": [
    {
      "id": "string",
      "projectId": "string",
      "name": "string",
      "tags": [
        "string"
      ],
      "sourceFormat": "string",
      "source": "upload",
      "huggingFace": {
        "type": "hugging_face",
        "repoId": "string",
        "revision": "string",
        "commitSha": "string",
        "subPath": "string",
        "licence": "string",
        "gated": "none",
        "sourceFormat": "lerobot-v3",
        "progress": {
          "filesDone": 0,
          "filesTotal": 0,
          "bytesDone": 0,
          "bytesTotal": 0
        },
        "failureReason": "HF_REPO_NOT_FOUND"
      },
      "status": {
        "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"
        }
      },
      "segmentationState": {
        "state": "not_segmented",
        "episodeCount": 0
      },
      "privacyState": "pending",
      "privacyRequirement": "required",
      "privacyGate": "human",
      "durationNs": 0,
      "collector": null,
      "posterUrl": "string",
      "latestReadyProcessingResultId": "string",
      "processedWith": {
        "workflowName": "string",
        "revision": 0
      },
      "rigProfile": {
        "name": "string",
        "revisionId": "string"
      },
      "captureLabels": {
        "tags": [
          "string"
        ],
        "scene": "string",
        "taskDescription": "string"
      },
      "rejectedSavedMinutes": 0,
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "nextPageToken": "string",
  "meta": {
    "pageSize": 0,
    "requestId": "string"
  }
}

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

{ "data": [ { "id": "string", "projectId": "string", "name": "string", "tags": [ "string" ], "sourceFormat": "string", "source": "upload", "huggingFace": { "type": "hugging_face", "repoId": "string", "revision": "string", "commitSha": "string", "subPath": "string", "licence": "string", "gated": "none", "sourceFormat": "lerobot-v3", "progress": { "filesDone": 0, "filesTotal": 0, "bytesDone": 0, "bytesTotal": 0 }, "failureReason": "HF_REPO_NOT_FOUND" }, "status": { "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" } }, "segmentationState": { "state": "not_segmented", "episodeCount": 0 }, "privacyState": "pending", "privacyRequirement": "required", "privacyGate": "human", "durationNs": 0, "collector": null, "posterUrl": "string", "latestReadyProcessingResultId": "string", "processedWith": { "workflowName": "string", "revision": 0 }, "rigProfile": { "name": "string", "revisionId": "string" }, "captureLabels": { "tags": [ "string" ], "scene": "string", "taskDescription": "string" }, "rejectedSavedMinutes": 0, "createdAt": "string", "updatedAt": "string" } ], "nextPageToken": "string", "meta": { "pageSize": 0, "requestId": "string" } }