Videos

GET /videos

Returns a paginated list with filtering, sorting, and metadata.

Name	Type	Required	Description
`path`	string	No	Filter by collection path
`filters`	object	No	Metadata field filters
`tags`	string	No	Comma-separated tags
`sort`	string	No	Sort field (prefix `-` for descending)
`per_page`	integer	No	Results per page (1-100, default 15)

Allowed sort columns: created_at, title, duration_in_seconds

sort=-created_at    # Newest first (default)
sort=title          # Alphabetical ascending
sort=-duration_in_seconds

Filter by collection:

curl "https://your-domain.com/api/client/v1/videos?path=root/marketing" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filter by metadata (operators: eq, neq, gt, gte, lt, lte, in):

curl "https://your-domain.com/api/client/v1/videos?filters[category][eq]=Tutorial" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filter by tags:

curl "https://your-domain.com/api/client/v1/videos?tags=promo,featured" \
  -H "Authorization: Bearer YOUR_API_KEY"

Sort by title ascending:

curl "https://your-domain.com/api/client/v1/videos?sort=title" \
  -H "Authorization: Bearer YOUR_API_KEY"

Paginated collection of video summaries with id, title, duration, thumbnail, metadata, and created_at.

Get Video

GET /videos/{videoId}

Returns full video details including manifest URLs, text tracks, thumbnails, and metadata.

curl "https://your-domain.com/api/client/v1/videos/{videoId}" \
  -H "Authorization: Bearer YOUR_API_KEY"

Status	Description
404	Video not found or not in your tenant