Videos

Get a video's timeline

Returns a compact ordered timeline outline by default: video identity, version, dimensions and duration plus every clip's video-timeline start, playback duration and content counts. Use include to fetch specific video or clip details, optionally scoped by clipIds; the complete outline remains in every response. Use include=all for the complete edit state. Effect and word times are ms on each clip's playback timeline (cuts applied). Raw cuts retain the source-recording timing used by the clip endpoints.

get/v1/videos/{id}/timeline

Request

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

Path parameters

idstring required

Unique video identifier

Example:vid_abc123def456

Query parameters

clipIdsstring

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

Example:scn_abc123,scn_def456
includestring

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

includedstring[] required

Detail categories included in this response

Changes

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