Videos

Start a video export

Starts an export of the specified video. Export processing is asynchronous: poll GET /v1/videos/{id}/exports/{exportId} for status and a download URL, or listen for the export.ready webhook. Creators and editors can always export. Viewers can only start an export if the video's download settings allow it: video and clips granularity require downloads to be enabled; tracks and raw require both downloads and raw downloads to be enabled.

post/v1/videos/{id}/exports

Request

  • Base URL: https://api.tella.com
  • URL: https://api.tella.com/v1/videos/{id}/exports
  • Auth: HTTP bearer

Path parameters

idstring required

Unique video identifier

Example:vid_abc123def456

Request body

fps'30' | '60'

Frames per second. 60 FPS requires the video creator's Premium plan (including Enterprise Premium), or Pro (including Enterprise) for videos up to 5 minutes after cuts. Not available during a free trial.

granularity'video' | 'clips' | 'tracks' | 'raw'

Export granularity: video (full video), clips (one composed file per clip), tracks (camera and screen files per clip with timeline cuts applied), raw (original recordings without cuts)

resolution'1080p' | '4k'

Export resolution. Default is 1080p. 4K requires the video creator's paid plan and is not available during a free trial.

speed'1' | '2' | '0.5' | '0.75' | '1.25' | '1.5' | '1.75'

Playback speed multiplier

subtitlesboolean

Burn subtitles into the video

Example request

{
  "fps": "30",
  "granularity": "video",
  "resolution": "1080p",
  "speed": "1"
}

Response

OK

Example response

{
  "export": {
    "downloadUrl": "https://cdn.tella.tv/exports/vid_abc123/video.mp4",
    "exportId": "Export-Story-vid_abc123def456/2026-01-15T10:00:00Z/Story/1920x1080/30FPS",
    "progress": 100,
    "status": "completed",
    "updatedAt": "2024-01-15T15:00:00.000Z"
  }
}

Changes

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