| Parameter | Type | Default | Description |
|---|---|---|---|
folder | str | None | Filter videos by folder name |
scope | 'user' | 'org' | 'sample' | None | Disambiguate folder lookup when personal and org folders share the same name. 'user' matches only personal folders, 'org' matches only organization folders, and 'sample' matches read-only demo/sample folders. When None, personal folders are preferred. |
List[Dict] - Each dict contains:
| Field | Type | Description |
|---|---|---|
video_id | str | Unique video identifier |
video_name | str | Original filename |
duration_s | float | Video duration in seconds |
folder_id | str | Folder identifier |
status | str | Upload status (see below) |
folder_name | str | Folder name (when filtering by folder) |
org_id | str | Organization ID (if org-scoped) |
| Status | Meaning |
|---|---|
processing | Upload in progress |
uploading_failed | Upload failed |
uploaded | Ready for analysis |