List episodes in a project

GET

/v1/projects/{projectId}/episodes

curl -X GET 'https://api.embodiflow.io/v1/projects/{projectId}/episodes' \
  -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.
verdictstring
Allowed values
fail
warning
incomplete
pass
not_checked
failingCheckstring
recordingIdstring (uuid)
collectionOrderIdstring (uuid)
collectionTaskIdstring (uuid)
collectorIdstring (uuid)
uploadedAfterstring
uploadedBeforestring
taskstring
taskExactstring
taskMissingboolean
outcomestring
Allowed values
success
failure
partial
tagstring
attributeobject
splitTagstring
Allowed values
train
val
test
versionSplitstring
Allowed values
train
val
test
durationMinnumber
durationMaxnumber
durationMaxExclusivenumber
subtaskCountMinnumber
subtaskCountMaxnumber
subtaskCountMaxExclusivenumber
cameraCountMinnumber
cameraCountMaxnumber
cameraCountMaxExclusivenumber
fpsMinnumber
fpsMaxnumber
fpsMaxExclusivenumber
idleFractionMinnumber
idleFractionMaxnumber
idleFractionMaxExclusivenumber
sceneIdstring (uuid)
labelStatestring
Allowed values
suggested
labeled
approved
rejected
hasSubtasksboolean
annotationJobIdstring (uuid)
selectionRunIdstring (uuid)
qstring
Natural-language rank within the project. Ignores sort.
sortstring
Allowed values
upload_date
duration
verdict
recording_name
orderstring
Allowed values
asc
desc

Responses

Success

dataarray<EpisodeListRowDto>required
- episodeIdstringrequired
- recordingIdstringrequired
- recordingNamestringrequired
- startNsnumberrequired
- endNsnumberrequired
- durationNsnumberrequired
- cameraKeysarray<string>required
- posterUrlstring | nullrequired
- taskobject | nullrequired
- outcomestring | nullrequired
- subtaskCountnumberrequired
- tagsarray<string>required
- attributesobjectrequired
- splitTagstring | nullrequired
- labelStatestringrequired
- verdictstringrequired
  Allowed values
  warning
  fail
  pass
  incomplete
  not_checked
- verdictReasonstring | nullrequired
- issueCountnumberrequired
- collectorany | nullrequired
- headRevisionIdstring | nullrequired
- confidencenumber | nullrequired
- excludedone ofrequired
- provenancestringrequired
  Allowed values
  human
  ai_proposed
- reviewedone ofrequired
- semanticScorenumber
nextPageTokenstring
Opaque AIP-158 page token. Omitted when the collection is exhausted.
metaobjectrequired
- pageSizenumberrequired
- totalCountnumber
- truncatedone of
- requestIdstring

Response example

{
  "data": [
    {
      "episodeId": "string",
      "recordingId": "string",
      "recordingName": "string",
      "startNs": 0,
      "endNs": 0,
      "durationNs": 0,
      "cameraKeys": [
        "string"
      ],
      "posterUrl": "string",
      "task": {
        "en": "string",
        "zh": "string"
      },
      "outcome": "string",
      "subtaskCount": 0,
      "tags": [
        "string"
      ],
      "attributes": {},
      "splitTag": "string",
      "labelState": "string",
      "verdict": "warning",
      "verdictReason": "string",
      "issueCount": 0,
      "collector": null,
      "headRevisionId": "string",
      "confidence": 0,
      "excluded": false,
      "provenance": "human",
      "reviewed": false,
      "semanticScore": 0
    }
  ],
  "nextPageToken": "string",
  "meta": {
    "pageSize": 0,
    "totalCount": 0,
    "truncated": false,
    "requestId": "string"
  }
}

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

{ "data": [ { "episodeId": "string", "recordingId": "string", "recordingName": "string", "startNs": 0, "endNs": 0, "durationNs": 0, "cameraKeys": [ "string" ], "posterUrl": "string", "task": { "en": "string", "zh": "string" }, "outcome": "string", "subtaskCount": 0, "tags": [ "string" ], "attributes": {}, "splitTag": "string", "labelState": "string", "verdict": "warning", "verdictReason": "string", "issueCount": 0, "collector": null, "headRevisionId": "string", "confidence": 0, "excluded": false, "provenance": "human", "reviewed": false, "semanticScore": 0 } ], "nextPageToken": "string", "meta": { "pageSize": 0, "totalCount": 0, "truncated": false, "requestId": "string" } }