Skip to main content
GET
Get a streaming upload storyboard

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

sourceId
string
required

Streaming upload source identifier

Example:

"su_abc123def456"

Query Parameters

startTimeMs
integer

Start time in ms on the selected target's playback timeline. Defaults to 0.

Required range: 0 <= x <= 2147483647
Example:

1000

durationMs
integer

Storyboard window duration in ms. Defaults to 80000; the selected target's remaining duration may shorten it. Pass the target's full duration to sample it end to end.

Required range: 1 <= x <= 2147483647
Example:

30000

response
enum<string>

Set to 'json' to receive {url, columns, rows, intervalMs} instead of the default 302 redirect.

Available options:
json
Example:

"json"

Response

Returned when ?response=json is set

Signed CDN URL plus the grid layout of the requested 4x4 WebP storyboard. Returned only when ?response=json is set; otherwise the endpoint redirects to the URL with a 302.

columns
integer
required

Tiles per row

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

4

intervalMs
integer
required

Spacing between tiles in ms. Tile i (row-major) shows the frame at startTimeMs + i * intervalMs.

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

5000

rows
integer
required

Tile rows

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

4

url
string<uri>
required

Signed CDN URL of the WebP sheet