Skip to main content
GET
Get a video's timeline

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Unique video identifier

Example:

"vid_abc123def456"

Query Parameters

clipIds
string

Comma-separated clip IDs to return details for. The complete ordered clip outline is always returned.

Example:

"scn_abc123,scn_def456"

include
string

Comma-separated details to include: all, settings, chapters, backgroundMusic, clipSettings, cuts, layouts, zooms, blurs, highlights, overlays, textOverlays, soundEffects, transcript, words. Default: none.

Example:

"layouts,zooms,words"

Response

The video's edit state

A compact video timeline with optional video-level and clip-level details

clips
object[]
required

Complete clip outline in playback order

included
enum<string>[]
required

Detail categories included in this response

Available options:
settings,
chapters,
backgroundMusic,
clipSettings,
cuts,
layouts,
zooms,
blurs,
highlights,
overlays,
textOverlays,
soundEffects,
transcript,
words
video
object
required

Minimal video timeline summary

details
object

Present only when at least one detail category is requested