Skip to main content
GET
/
v1
/
videos
List all videos
curl --request GET \
  --url https://api.tella.com/v1/videos \
  --header 'Authorization: Bearer <token>'
{
  "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",
      "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
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://tella.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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"

Response

OK

pagination
object
required

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

videos
object[]
required

List of videos