Sign in
Videos

List all videos

Returns a paginated list of all videos for the authenticated user. Use playlistId query parameter to filter videos by playlist.

get/v1/videos

Query parameters

cursorstring

Pagination cursor from previous response

Example:eyJpZCI6InZpZF94eXoifQ

Pagination cursor from previous response

limitinteger

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

Example:20

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

playlistIdstring

Filter videos by playlist ID

Example:pl_xyz789ghi012

Filter videos by playlist ID

tagIdsstring

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

Example:tag_abc123def456,tag_ghi789jkl012

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

Response

OK

Example response

{
  "pagination": {
    "hasMore": true,
    "nextCursor": "eyJpZCI6IjEyMyJ9"
  },
  "videos": [
    {
      "aspectRatio": "16:9",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "description": "Learn how to create and share your first video",
      "dimensions": {
        "height": 1080,
        "width": 1920
      },
      "id": "vid_abc123def456",
      "links": {
        "embedPage": "https://www.tella.tv/video/vid_abc123def456/embed",
        "viewPage": "https://www.tella.tv/video/vid_abc123def456/view"
      },
      "name": "Getting Started with Tella",
      "updatedAt": "2024-01-15T14:45:00.000Z",
      "views": 1234
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.