Skip to main content

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.

​
Quickstart

Get up and running with the Tella API in just a few minutes.

​
Step 1: Get your API key

  1. Go to your Tella account settings
  2. Click Create key
  3. Copy your new API key (it starts with tella_pk_)
Keep your API key secure. Never share it publicly or commit it to version control.

​
Step 2: Make your first request

To list all videos in your workspace, make the following request: 
curl -H "Authorization: Bearer tella_pk_your_api_key" \
  https://api.tella.com/v1/videos

​
Step 3: Explore the response

A successful response looks like this: 
{
  "videos": [
    {
      "id": "abc123xyz",
      "name": "Product Demo",
      "description": "A walkthrough of our new feature",
      "views": 1234,
      "durationSeconds": 125.5,
      "aspectRatio": "16:9",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z",
      "links": {
        "viewPage": "https://www.tella.tv/video/abc123xyz/view",
        "embedPage": "https://www.tella.tv/video/abc123xyz/embed"
      }
    }
  ],
  "pagination": {
    "nextCursor": null,
    "hasMore": false
  }
}

​
Step 4: Get video details

To get full details including the transcript: 
curl -H "Authorization: Bearer tella_pk_your_api_key" \
  https://api.tella.com/v1/videos/abc123xyz

​
Next steps

Authentication

Learn about API key management and security best practices.

Rate Limiting

Understand rate limits and how to handle them.

Webhooks

Set up webhooks to receive real-time event notifications.