Skip to main content
GET
List all videos

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Query Parameters

cursor
string

Pagination cursor from previous response

Example:

"eyJpZCI6InZpZF94eXoifQ"

limit
integer

Items per page (default: 20, max: 100)

Required range: 1 <= x <= 100
Example:

20

playlistId
string

Filter videos by playlist ID

Example:

"pl_xyz789ghi012"

tagIds
string

Filter videos by tag IDs, comma-separated. Multiple tags are combined with AND. Ignored when playlistId is set.

Example:

"tag_abc123def456,tag_ghi789jkl012"

scope
enum<string>

Which videos to list. personal (default) is your own library, the My videos tab: videos you created or were invited to. workspace is the Workspace videos tab: every video shared with the workspace, whoever made it, most recently updated first. With workspace, archived videos are left out after a page is read, so a page can be shorter than limit; keep paging while hasMore is true. workspace can't be combined with playlistId or tagIds.

Available options:
personal,
workspace
Example:

"workspace"

Response

OK

pagination
object
required

Pagination metadata for list responses. Results are sorted by updatedAt descending.

videos
object[]
required

List of videos