{
"docsUrl": "https://docs.tella.com/",
"error": "bad_request",
"message": "The request was malformed or contained invalid parameters."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "unauthorized",
"message": "Authentication is required. Provide a valid API key."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "forbidden",
"message": "You don't have permission to access this resource."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "not_found",
"message": "The requested resource was not found."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "conflict",
"message": "The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "rate_limited",
"message": "You have exceeded the rate limit. Please slow down."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "not_implemented",
"message": "The requested operation is not implemented."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "unavailable",
"message": "A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay."
}
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.
{
"docsUrl": "https://docs.tella.com/",
"error": "bad_request",
"message": "The request was malformed or contained invalid parameters."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "unauthorized",
"message": "Authentication is required. Provide a valid API key."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "forbidden",
"message": "You don't have permission to access this resource."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "not_found",
"message": "The requested resource was not found."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "conflict",
"message": "The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "rate_limited",
"message": "You have exceeded the rate limit. Please slow down."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "not_implemented",
"message": "The requested operation is not implemented."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "unavailable",
"message": "A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay."
}
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.
A compact video timeline with optional video-level and clip-level details
clips
object[]
required
Complete clip outline in playback order
Hide child attributes
clips.contents
object
required
Hide child attributes
clips.contents.blurs
integer
required
Required range: 0 <= x <= 9007199254740991
clips.contents.cuts
integer
required
Required range: 0 <= x <= 9007199254740991
clips.contents.highlights
integer
required
Required range: 0 <= x <= 9007199254740991
clips.contents.layouts
integer
required
Required range: 0 <= x <= 9007199254740991
clips.contents.overlays
integer
required
Required range: 0 <= x <= 9007199254740991
clips.contents.soundEffects
integer
required
Required range: 0 <= x <= 9007199254740991
clips.contents.textOverlays
integer
required
Required range: 0 <= x <= 9007199254740991
clips.contents.transcriptWords
integer | null
required
Number of transcript words on the clip playback timeline, including hidden words. Null when transcript data could not be read.
Required range: 0 <= x <= 9007199254740991
clips.contents.zooms
integer
required
Required range: 0 <= x <= 9007199254740991
clips.durationMs
number
required
Clip playback duration in ms, with cuts removed
Required range: x >= 0
clips.id
string
required
clips.name
string
required
clips.order
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
clips.timelineStartMs
number
required
Clip start time in ms on the complete video timeline
Required range: x >= 0
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
Hide child attributes
video.aspectRatio
string
required
Example:
"16:9"
video.description
string
required
Maximum string length: 5000
video.dimensions
object
required
Hide child attributes
video.dimensions.height
number
required
Canvas height in pixels
video.dimensions.width
number
required
Canvas width in pixels
video.durationMs
number
required
Total playback duration in ms
Required range: x >= 0
video.id
string
required
video.name
string
required
video.updatedAt
string
required
ISO-8601 timestamp of the video version represented
details
object
Present only when at least one detail category is requested
Hide child attributes
details.clips
object[]
Hide child attributes
details.clips.clipId
string
required
details.clips.background
object
Clip background. Use type = 'solid' with color, type = 'image' or 'video' with sourceId (from POST /v1/sources) or an exact catalog URL from GET /v1/backgrounds, type = 'gradient' with gradientColor1, gradientColor2, gradientAngle, type = 'shaderGradient' with shaderGradientPreset, or type = 'ambient'.
Hide child attributes
details.clips.background.type
enum<string>
required
Background variant. ambient: the clip's screen, else its camera, heavily blurred; no other fields. shaderGradient: an animated gradient set by shaderGradientPreset; echoing a non-preset one unchanged keeps it.
Available options:
solid,
gradient,
image,
video,
shaderGradient,
ambient
Example:
"solid"
details.clips.background.color
string | null
Hex color string. Required when type = 'solid'.
Example:
"#000000ff"
details.clips.background.gradientAngle
integer | null
Linear gradient angle in degrees. Required when type = 'gradient'.
Required range: -9007199254740991 <= x <= 9007199254740991
Example:
45
details.clips.background.gradientColor1
string | null
Hex color string. Required when type = 'gradient'.
Example:
"#ff0080ff"
details.clips.background.gradientColor2
string | null
Hex color string. Required when type = 'gradient'.
Example:
"#7928caff"
details.clips.background.imageUrl
string<uri> | null
Hosted image URL. Present in responses and accepted as input only when copied exactly from GET /v1/backgrounds; otherwise pass sourceId.
details.clips.background.shaderGradientPreset
string | null
Animated gradient preset from GET /v1/backgrounds. Required when type = 'shaderGradient'.
Example:
"Halo"
details.clips.background.sourceId
string | null
Source ID from POST /v1/sources (kind: image for type = 'image', kind: video for type = 'video'). Required for image/video backgrounds unless using an exact URL from GET /v1/backgrounds. A video background source must have its file uploaded, be 20 MB or smaller, and not be an audio or auto capture source; it is also saved to your uploaded video backgrounds, like an upload in the editor. Input-only.
Example:
"su_abc123"
details.clips.background.videoDurationSeconds
number | null
Video background duration in seconds. Read-only: derived from the uploaded source or catalog entry on input.
Required range: x >= 0
Example:
12.4
details.clips.background.videoUrl
string<uri> | null
Hosted video URL. Present in responses and accepted as input only when copied exactly from GET /v1/backgrounds; otherwise pass sourceId.
details.clips.blurs
object[]
Hide child attributes
details.clips.blurs.dimensions
object
required
Size of the masked rectangle (percentages)
Hide child attributes
details.clips.blurs.dimensions.heightPct
number
required
Required range: 0 <= x <= 100
Example:
50
details.clips.blurs.dimensions.widthPct
number
required
Required range: 0 <= x <= 100
Example:
50
details.clips.blurs.durationMs
number
required
Required range: x >= 0
Example:
2000
details.clips.blurs.id
string
required
Mask ID
Example:
"ly_abc123"
details.clips.blurs.intensity
number
required
Strength from 0 to 1. Blur: 0 is the standard blur and 1 blurs three times as heavily; the content stays fully hidden at every value (defaults to 0). Highlight: how dark the area outside the highlight goes, 0 = no dimming, 1 = black (defaults to 0.7).
Required range: 0 <= x <= 1
Example:
0.7
details.clips.blurs.point
object
required
Top-left corner of the masked rectangle (percentages)
Hide child attributes
details.clips.blurs.point.xPct
number
required
Required range: 0 <= x <= 100
Example:
25
details.clips.blurs.point.yPct
number
required
Required range: 0 <= x <= 100
Example:
25
details.clips.blurs.startTimeMs
number
required
Start time in ms on the clip's playback timeline (cuts applied)
Required range: x >= 0
Example:
1000
details.clips.blurs.transition
enum<string>
required
smooth fades the mask in and out, hard_cut pops it. New masks start on hard_cut.
Available options:
smooth,
hard_cut
Example:
"smooth"
details.clips.blurs.type
enum<string>
required
Available options:
blur,
highlight
Example:
"blur"
details.clips.blurs.cornerRadius
number
Corner radius from 0 to 64, in the clip's corner units (regular is the video's corner radius, 16 by default, and squircle twice that). Overrides the corners preset's radius, so it needs corners regular or squircle (in the request or already set); setting corners without it goes back to the preset's radius. Absent when the preset's radius applies.
Required range: 0 <= x <= 64
Example:
24
details.clips.blurs.corners
enum<string>
How the highlighted area's corners are rounded. auto (the default) follows the clip's corners; the others override it for this highlight. Highlights only.
Available options:
auto,
none,
regular,
squircle
Example:
"regular"
details.clips.cuts
object[]
Raw cut definitions in ms of the source recording, matching get_clip
Hide child attributes
details.clips.cuts.durationMs
integer
required
Length of the cut, in milliseconds
Required range: 0 < x <= 9007199254740991
Example:
750
details.clips.cuts.startTimeMs
integer
required
Start of the cut, in ms of the raw recording
Required range: 0 <= x <= 9007199254740991
Example:
1500
details.clips.highlights
object[]
Hide child attributes
details.clips.highlights.dimensions
object
required
Size of the masked rectangle (percentages)
Hide child attributes
details.clips.highlights.dimensions.heightPct
number
required
Required range: 0 <= x <= 100
Example:
50
details.clips.highlights.dimensions.widthPct
number
required
Required range: 0 <= x <= 100
Example:
50
details.clips.highlights.durationMs
number
required
Required range: x >= 0
Example:
2000
details.clips.highlights.id
string
required
Mask ID
Example:
"ly_abc123"
details.clips.highlights.intensity
number
required
Strength from 0 to 1. Blur: 0 is the standard blur and 1 blurs three times as heavily; the content stays fully hidden at every value (defaults to 0). Highlight: how dark the area outside the highlight goes, 0 = no dimming, 1 = black (defaults to 0.7).
Required range: 0 <= x <= 1
Example:
0.7
details.clips.highlights.point
object
required
Top-left corner of the masked rectangle (percentages)
Hide child attributes
details.clips.highlights.point.xPct
number
required
Required range: 0 <= x <= 100
Example:
25
details.clips.highlights.point.yPct
number
required
Required range: 0 <= x <= 100
Example:
25
details.clips.highlights.startTimeMs
number
required
Start time in ms on the clip's playback timeline (cuts applied)
Required range: x >= 0
Example:
1000
details.clips.highlights.transition
enum<string>
required
smooth fades the mask in and out, hard_cut pops it. New masks start on hard_cut.
Available options:
smooth,
hard_cut
Example:
"smooth"
details.clips.highlights.type
enum<string>
required
Available options:
blur,
highlight
Example:
"blur"
details.clips.highlights.cornerRadius
number
Corner radius from 0 to 64, in the clip's corner units (regular is the video's corner radius, 16 by default, and squircle twice that). Overrides the corners preset's radius, so it needs corners regular or squircle (in the request or already set); setting corners without it goes back to the preset's radius. Absent when the preset's radius applies.
Required range: 0 <= x <= 64
Example:
24
details.clips.highlights.corners
enum<string>
How the highlighted area's corners are rounded. auto (the default) follows the clip's corners; the others override it for this highlight. Highlights only.
Available options:
auto,
none,
regular,
squircle
Example:
"regular"
details.clips.layoutSceneType
enum<string>
The clip's scene type, which decides the layouts it can use. Present when clipSettings or layouts is requested
Available options:
basicSubject,
cameraSubject,
combi
Example:
"combi"
details.clips.layouts
object[]
Hide child attributes
details.clips.layouts.id
string
required
Layout ID
details.clips.layouts.media
object[]
required
B-roll media on this layout — one entry per filled slot (screen and/or camera). Empty on the base layout and on layouts whose underlying section carries no media. Each entry's slot says which slot it fills.
Hide child attributes
details.clips.layouts.media.type
enum<string>
required
Available options:
image,
video,
motion
details.clips.layouts.media.documentId
string
The Tella Motion document (ffd_…) that motion media plays.
details.clips.layouts.media.height
integer | null
Image height in pixels (image media only).
Required range: -9007199254740991 <= x <= 9007199254740991
details.clips.layouts.media.imageUrl
string | null
Hosted image URL, for image media. Read-only: not accepted as input — pass sourceId instead.
details.clips.layouts.media.muted
boolean | null
True when video media plays with its own audio silenced.
details.clips.layouts.media.slot
enum<string>
Which slot the media fills: screen (the subject/main frame, the default) or camera (the bubble/presentation slot — a media bubble over the recording behind it). A camera slot requires a layout that renders the camera (e.g. camera-bubble, side-by-side, tv-presenter).
Available options:
screen,
camera
details.clips.layouts.media.sourceId
string | null
Source ID the media was created from. Absent for image media added in the editor.
details.clips.layouts.media.startTimeMs
number | null
Video media only: where it starts in its source, in ms. Absent when it plays from the start.
details.clips.layouts.media.width
integer | null
Image width in pixels (image media only).
Required range: -9007199254740991 <= x <= 9007199254740991
details.clips.layouts.cameraStyle
enum<string>
The camera's frame shape, as the editor's Camera style picker sets it, overriding the named layout's own: circle, square, portrait, none (a rectangle in the camera slot's aspect, rounded by the clip's corners, e.g. a squircle when corners are squircle), cutout (the presenter cut out of the camera feed with no frame), blob or blob-outline. It shapes the camera bubble and the pop-out frame. Absent when the layout's own shape applies; custom layouts report it as presentation.shape instead.
Available options:
none,
circle,
square,
portrait,
cutout,
blob,
blob-outline
details.clips.layouts.crop
object | null
The crop of the clip's screen recording while this layout shows — the layout's own crop, else the clip's. Absent when the recording is uncropped.
Hide child attributes
details.clips.layouts.crop.bottom
number
required
Pixels of the screen recording removed from its bottom edge
Required range: x >= 0
details.clips.layouts.crop.left
number
required
Pixels of the screen recording removed from its left edge
Required range: x >= 0
details.clips.layouts.crop.right
number
required
Pixels of the screen recording removed from its right edge
Required range: x >= 0
details.clips.layouts.crop.top
number
required
Pixels of the screen recording removed from its top edge
Required range: x >= 0
details.clips.layouts.durationMs
number | null
Layout duration in ms. Omitted for clip-spanning layouts.
Required range: x >= 0
Example:
5000
details.clips.layouts.followsBase
boolean
True when this layout follows the clip's base layout: updating the base layout changes it too, so it needs no update of its own. False when it has its own layout. Absent on the base layout itself.
details.clips.layouts.layout
Fullscreen · object
Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as kind: custom. Null only for internal layouts outside the public vocabulary.
Fullscreen
Middle
Side by Side
TV Presenter
Cut Out
Camera Bubble
Camera Only
Screen Only
Custom
Hide child attributes
details.clips.layouts.layout.kind
enum<string>
required
Available options:
fullscreen
details.clips.layouts.layout.screenFit
enum<string>
Only honoured for basic-subject clips (Tella renders the screen fullscreen). Defaults to cover.
Available options:
cover,
letterbox
details.clips.layouts.layout.style
enum<string>
regular (default) is plain fullscreen; stretch punches in to 1.15x. On basic-subject clips stretch needs uploaded footage (not a screen recording).
Available options:
regular,
stretch
details.clips.layouts.popOut
object | null
The camera's pop-out while this layout shows. Absent when it is off.
Hide child attributes
details.clips.layouts.popOut.amount
number
How far the frame shrinks below the presenter, as a fraction of the camera slot (0–0.5). Defaults to 0.22.
Required range: 0 <= x <= 0.5
details.clips.layouts.popOut.background
enum<string>
What fills the frame behind the presenter: original keeps the camera feed, color paints color. Defaults to original.
Available options:
original,
color
details.clips.layouts.popOut.color
string
Frame fill when background is color, as #RRGGBB or #RRGGBBAA. Defaults to #6366F1.
Pattern: ^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$
details.clips.layouts.popOut.outlineColor
string
Outline colour as #RRGGBB or #RRGGBBAA. Defaults to #FFFFFF.
Pattern: ^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$
details.clips.layouts.popOut.outlineWidth
number
Outline around the frame as a fraction of its width (0–0.05); 0 draws none. Defaults to 0.
Required range: 0 <= x <= 0.05
details.clips.layouts.startTimeMs
number | null
Layout start time in ms on the clip's playback timeline (cuts applied). Omitted for clip-spanning layouts.
Required range: x >= 0
Example:
0
details.clips.layouts.transitionStyle
enum<string> | null
Transition into this layout. Omitted on the base layout, or when the section uses an internal style not exposed via the public API.
Available options:
spring,
hardCut
details.clips.microphoneVolume
number | null
Clip microphone volume override: a number when overridden, null when following the video, absent when there is no microphone audio
Required range: 0 <= x <= 2
details.clips.overlays
object[]
Hide child attributes
details.clips.overlays.animation
object | null
required
How the overlay enters and leaves, or null when it plays its transition.
Hide child attributes
details.clips.overlays.animation.intro
object | null
required
How the whole overlay enters, or null when it appears instantly.
Hide child attributes
details.clips.overlays.animation.intro.blur
number
required
Blur of the hidden state in pixels.
Example:
0
details.clips.overlays.animation.intro.clip
boolean
required
Clip the motion to the overlay's box, so it wipes in like a mask.
Example:
false
details.clips.overlays.animation.intro.durationMs
integer
required
How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.
Required range: -9007199254740991 <= x <= 9007199254740991
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. front paints over everything. behind_presenter paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on front. Without a presenter the overlay paints in front either way.
Available options:
front,
behind_presenter
Example:
"behind_presenter"
details.clips.overlays.dimensions
object
required
Overlay size in artboard pixels. Absolute (not a percentage) so the overlay shape never distorts when the artboard dimensions change. Both sides must be greater than 0 — the renderer lays the overlay out into this box, so a zero or negative side has no valid meaning.
Hide child attributes
details.clips.overlays.dimensions.height
number
required
Required range: x > 0
Example:
540
details.clips.overlays.dimensions.width
number
required
Required range: x > 0
Example:
960
details.clips.overlays.durationMs
number
required
Required range: x >= 0
Example:
5000
details.clips.overlays.id
string
required
Overlay ID
Example:
"ly_abc123"
details.clips.overlays.point
object
required
Top-left corner of the overlay, as a percentage of the video canvas (0-100). Relative so the anchor survives video aspect ratio changes.
Hide child attributes
details.clips.overlays.point.xPct
number
required
Example:
30
details.clips.overlays.point.yPct
number
required
Example:
30
details.clips.overlays.startTimeMs
number
required
Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.
Required range: x >= 0
Example:
1000
details.clips.overlays.transition
enum<string>
required
Intro/outro animation: smooth fades the overlay in at its start and out at its end, hard_cut pops it in and out. New overlays start on hard_cut. An animation replaces it while set.
Available options:
smooth,
hard_cut
Example:
"hard_cut"
details.clips.overlays.type
enum<string>
required
motion plays a Tella Motion document of the video's live (motionDocumentId).
Available options:
image,
video,
motion
Example:
"image"
details.clips.overlays.zIndex
integer
required
Stacking position among the clip's image, video and text overlays: 0 is the backmost. depth applies first — a behind_presenter overlay stays behind the presenter whatever its zIndex — so the order only matters among overlays at the same depth. Lottie overlays share the stack but aren't listed, so listed values can skip a number.
Required range: 0 <= x <= 9007199254740991
Example:
0
details.clips.overlays.depthChanges
object[]
Changes of depth over the overlay's own time, each held until the next: atMs after the overlay starts it moves to that depth, so one overlay can pass in front of the presenter and back behind them (a ring orbiting their head, a title they step in front of). depth is where it starts. On updates, omit it to leave the changes as they are; [] removes them. Absent in responses while the overlay holds one depth.
Hide child attributes
details.clips.overlays.depthChanges.atMs
number
required
Ms after the overlay starts.
Required range: x >= 0
Example:
1200
details.clips.overlays.depthChanges.depth
enum<string>
required
Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. front paints over everything. behind_presenter paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on front. Without a presenter the overlay paints in front either way.
Available options:
front,
behind_presenter
Example:
"behind_presenter"
details.clips.overlays.imageUrl
string | null
Hosted image URL, for image overlays. Read-only: not accepted as input — pass sourceId instead.
details.clips.overlays.motionDocumentId
string
The Tella Motion document (ffd_…) a motion overlay plays. Edit it with POST /v1/motion/documents/{id}/commands.
Example:
"ffd_abc123"
details.clips.overlays.name
string | null
Example:
"Logo"
details.clips.overlays.sourceId
string | null
Source ID the overlay was created from.
Example:
"su_abc123"
details.clips.soundEffects
object[]
Hide child attributes
details.clips.soundEffects.durationMs
number
required
Required range: x >= 0
Example:
3000
details.clips.soundEffects.id
string
required
Sound effect ID
Example:
"ly_abc123"
details.clips.soundEffects.startTimeMs
number
required
Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.
Required range: x >= 0
Example:
1000
details.clips.soundEffects.volume
number
required
Playback volume (1 = original).
Example:
1
details.clips.soundEffects.name
string | null
Example:
"Whoosh"
details.clips.soundEffects.sourceId
string | null
Example:
"su_abc123"
details.clips.studioSound
boolean
Effective Studio Sound state: the video-level switch minus this clip's opt-out
details.clips.systemAudioVolume
number | null
Clip system audio override: a number when overridden, null when following the video, absent when there is no system audio
Required range: 0 <= x <= 2
details.clips.textOverlays
object[]
Hide child attributes
details.clips.textOverlays.animation
object | null
required
How the text enters and leaves, or null when it plays its transition.
Hide child attributes
details.clips.textOverlays.animation.intro
object | null
required
How the whole overlay enters, or null when it appears instantly.
Hide child attributes
details.clips.textOverlays.animation.intro.blur
number
required
Blur of the hidden state in pixels.
Example:
0
details.clips.textOverlays.animation.intro.clip
boolean
required
Clip the motion to the overlay's box, so it wipes in like a mask.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
Background behind the text. Overlays with no visible box report a solid #00000000.
Hide child attributes
details.clips.textOverlays.background.color
string
required
Hex color string. Required when type = 'solid'. Transparent backgrounds use #00000000.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#5E51F8FF"
details.clips.textOverlays.background.type
enum<string>
required
Background variant. Text overlays take a solid background; the other ClipBackground variants are not supported behind text.
Available options:
solid
Example:
"solid"
details.clips.textOverlays.backgroundPadding
number
required
Extra room around the text inside its background, as a fraction of the font size added on every side (0.5 at an 80px font adds 40px). 0 is the standard padding. No effect without a visible background.
Required range: 0 <= x <= 1
Example:
0.25
details.clips.textOverlays.backgroundShape
enum<string>
required
Shape of the solid background behind the text.
Available options:
none,
regular,
squircle
Example:
"squircle"
details.clips.textOverlays.color
string
required
Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#FFFFFFFF"
details.clips.textOverlays.cornerRadius
number | null
required
The background's own corner radius in story pixels, or null for its shape's.
Required range: 0 <= x <= 512
Example:
24
details.clips.textOverlays.depth
enum<string>
required
Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. front paints over everything. behind_presenter paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on front. Without a presenter the overlay paints in front either way.
Available options:
front,
behind_presenter
Example:
"behind_presenter"
details.clips.textOverlays.dimensions
object
required
Overlay size in artboard pixels. Absolute (not a percentage) so the overlay shape never distorts when the artboard dimensions change. Both sides must be greater than 0 — the renderer lays the overlay out into this box, so a zero or negative side has no valid meaning.
Hide child attributes
details.clips.textOverlays.dimensions.height
number
required
Required range: x > 0
Example:
540
details.clips.textOverlays.dimensions.width
number
required
Required range: x > 0
Example:
960
details.clips.textOverlays.durationMs
number
required
Required range: x >= 0
Example:
5000
details.clips.textOverlays.fontFamily
string
required
The overlay's font family. Normally one of the catalog families accepted on write, or a library font's family when fontId is set. Overlays created before that catalog can report another bundled family, such as Graphik.
Example:
"Inter"
details.clips.textOverlays.fontSize
number
required
Font size in artboard pixels — absolute, like dimensions, so text keeps its size relative to the frame. Renderers scale it by their render scale factor.
Required range: x > 0
Example:
81
details.clips.textOverlays.fontWeight
number
required
Variable-font weight axis — 100 (thin) to 900 (black).
Example:
500
details.clips.textOverlays.fontWidth
number
required
Variable-font width axis, as a percentage — 100 is normal, 50 ultra-condensed, 150 extra-expanded.
Example:
100
details.clips.textOverlays.id
string
required
Text overlay ID
Example:
"ly_abc123"
details.clips.textOverlays.letterSpacing
number
required
Tracking: space between letters, as a fraction of the font size (-0.05 at an 80px font pulls letters 4px closer; 0.1 spreads them 8px apart). Negative tightens; 0 is the font's own spacing.
Required range: -0.2 <= x <= 1
Example:
-0.02
details.clips.textOverlays.lineHeight
number
required
Distance between baselines, as a multiple of the font size (1.5 at an 80px font puts lines 120px apart). 1.2 is the standard spacing.
Required range: 0.8 <= x <= 3
Example:
1.5
details.clips.textOverlays.outline
string | null
required
Color of the outline (stroke) drawn around the letters, or null for no outline.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#000000FF"
details.clips.textOverlays.point
object
required
Top-left corner of the overlay, as a percentage of the video canvas (0-100). Relative so the anchor survives video aspect ratio changes.
Hide child attributes
details.clips.textOverlays.point.xPct
number
required
Example:
30
details.clips.textOverlays.point.yPct
number
required
Example:
30
details.clips.textOverlays.shadow
enum<string>
required
Drop shadow, matching the editor's Shadow menu. It falls from the background box when the text has one, else from the letters.
Available options:
none,
subtle,
deep
Example:
"subtle"
details.clips.textOverlays.startTimeMs
number
required
Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.
Required range: x >= 0
Example:
1000
details.clips.textOverlays.text
string
required
Example:
"Welcome back"
details.clips.textOverlays.textAlign
enum<string>
required
Horizontal alignment of the text inside its overlay box.
Available options:
left,
center,
right
Example:
"center"
details.clips.textOverlays.transition
enum<string>
required
Intro/outro animation: smooth fades the text in at its start and out at its end, hard_cut pops it in and out. New text overlays start on hard_cut. An animation replaces it while set.
Available options:
smooth,
hard_cut
Example:
"hard_cut"
details.clips.textOverlays.zIndex
integer
required
Stacking position among the clip's image, video and text overlays: 0 is the backmost. depth applies first — a behind_presenter overlay stays behind the presenter whatever its zIndex — so the order only matters among overlays at the same depth. Lottie overlays share the stack but aren't listed, so listed values can skip a number.
Required range: 0 <= x <= 9007199254740991
Example:
0
details.clips.textOverlays.depthChanges
object[]
Changes of depth over the overlay's own time, each held until the next: atMs after the overlay starts it moves to that depth, so one overlay can pass in front of the presenter and back behind them (a ring orbiting their head, a title they step in front of). depth is where it starts. On updates, omit it to leave the changes as they are; [] removes them. Absent in responses while the overlay holds one depth.
Hide child attributes
details.clips.textOverlays.depthChanges.atMs
number
required
Ms after the overlay starts.
Required range: x >= 0
Example:
1200
details.clips.textOverlays.depthChanges.depth
enum<string>
required
Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. front paints over everything. behind_presenter paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on front. Without a presenter the overlay paints in front either way.
Available options:
front,
behind_presenter
Example:
"behind_presenter"
details.clips.textOverlays.fontId
string
The library font the overlay renders with (a font item's id), absent for a catalog family.
Example:
"media_abc123def456"
details.clips.transcript
object | null
Null when the clip has no speech or its transcript is unavailable
Hide child attributes
details.clips.transcript.text
string
required
Visible transcript text
details.clips.transcript.wordCount
integer
required
Required range: 0 <= x <= 9007199254740991
details.clips.words
object[] | null
Words in ms on the clip playback timeline. Includes hidden words so indices remain usable with transcript editing endpoints. Null when transcript data could not be read.
Hide child attributes
details.clips.words.breakAfter
boolean
required
Whether a subtitle break is forced after this word, so the next word always starts a new subtitle block
Example:
false
details.clips.words.endTimeMs
number
required
Word end time, in ms on the clip's playback timeline
Required range: x >= 0
Example:
1800
details.clips.words.hidden
boolean
required
Whether the word is hidden by an edit
Example:
false
details.clips.words.index
integer
required
Stable index of the word in the source recording
Required range: 0 <= x <= 9007199254740991
Example:
12
details.clips.words.keepWithNext
boolean
required
Whether this word's subtitle block is kept together with the next word across punctuation and pauses. The lines-per-block limit still applies and breakAfter wins.
Example:
false
details.clips.words.startTimeMs
number
required
Word start time, in ms on the clip's playback timeline
Required range: x >= 0
Example:
1500
details.clips.words.text
string
required
Word text
Example:
"Hello"
details.clips.zooms
object[]
Hide child attributes
details.clips.zooms.durationMs
number
required
Duration in ms of playback. 0 when the zoom's footage is entirely cut out.
Required range: x >= 0
Example:
2000
details.clips.zooms.id
string
required
Zoom ID
Example:
"ef_abc123"
details.clips.zooms.introTransition
enum<string>
required
How the zoom enters: smooth (the default) animates in, hard_cut jumps straight in.
Available options:
smooth,
hard_cut
Example:
"hard_cut"
details.clips.zooms.outroTransition
enum<string>
required
How the zoom leaves: smooth (the default) animates out, hard_cut jumps straight back.
Available options:
smooth,
hard_cut
Example:
"smooth"
details.clips.zooms.startTimeMs
number
required
Start time in ms on the clip's playback timeline (cuts applied)
Required range: x >= 0
Example:
1000
details.clips.zooms.type
enum<string>
required
manualZoom zooms into a fixed focusPoint on the screen. trackingZoom automatically follows the cursor in the screen recording.
Available options:
manualZoom,
trackingZoom
Example:
"manualZoom"
details.clips.zooms.focusPoint
object | null
Point on the zoomed footage to zoom into, expressed as percentages of its dimensions. Required for manualZoom; ignored for trackingZoom.
Hide child attributes
details.clips.zooms.focusPoint.xPct
number
required
Horizontal position on the screen frame (0-100). 0 = left edge.
Required range: 0 <= x <= 100
Example:
50
details.clips.zooms.focusPoint.yPct
number
required
Vertical position on the screen frame (0-100). 0 = top edge.
Required range: 0 <= x <= 100
Example:
50
details.clips.zooms.scale
number | null
Magnification factor (1 = no zoom, 3.5 = max).
Required range: 1 <= x <= 3.5
Example:
2
details.video
object
Hide child attributes
details.video.backgroundMusic
object | null
One video-wide track that loops over the whole video and is included in exports
Hide child attributes
details.video.backgroundMusic.durationMs
number
required
Audio track duration in milliseconds
Required range: x > 0
Example:
180036
details.video.backgroundMusic.name
string | null
required
Optional display name for the track
Example:
"Calm Product Tour"
details.video.backgroundMusic.url
string<uri>
required
HTTPS URL of the audio track
Pattern: ^https:\/\/.*
Example:
"https://ucarecdn.com/example-track/"
details.video.backgroundMusic.volume
number
required
Track volume from 0 (silent) to 1 (full volume)
Required range: 0 <= x <= 1
Example:
0.2
details.video.chapters
object[]
Hide child attributes
details.video.chapters.description
string
required
Chapter description
Maximum string length: 5000
Example:
"Overview of what we'll cover"
details.video.chapters.timestampSeconds
number
required
Chapter start time in seconds
Required range: x >= 0
Example:
0
details.video.chapters.title
string
required
Chapter title
Required string length: 1 - 255
Example:
"Introduction"
details.video.settings
object
Video playback and access settings
Hide child attributes
details.video.settings.allowedEmbedDomains
string[]
required
Restrict embedding to these domains only (Premium feature). Empty array allows all domains.
Example:
["example.com", "mysite.org"]
details.video.settings.callToAction
object | null
required
The video's own call-to-action button on its share page. null when it has none, in which case workspaceCallToAction shows instead.
Hide child attributes
details.video.settings.callToAction.label
string
required
Button text
Required string length: 1 - 100
details.video.settings.callToAction.url
string
required
Where the button links, starting https:// or http://
Example:
"https://docs.tella.com/help"
details.video.settings.callToActionsHidden
boolean
required
Every call-to-action button is hidden on the share page, the workspace defaults included.
details.video.settings.captionFontFamily
string
required
Subtitle font family. On write, one of Tella's catalog font families or the built-in subtitle families Dela Gothic One, Lato, Georgia, and Arial, or the video's current family to keep an uploaded font. Reads report the family the subtitles render with.
Minimum string length: 1
Example:
"Inter"
details.video.settings.captionFontSize
number
required
Exact subtitle text size, 40 to 200 — the editor's Size slider. captionSize is the same setting in buckets (small 40, medium 64, large 80), so a request passes one or the other, not both.
Required range: 40 <= x <= 200
Example:
64
details.video.settings.captionFontWeight
number
required
Subtitle font weight, 100 (thin) to 1000. Catalog fonts clamp to their supported range; built-in subtitle fonts outside the catalog snap to an available weight. Dela Gothic One uses 400 only; Arial uses 400 or 700. Reads report the weight that renders. Sent without captionFontFamily, it re-weights the video's current font.
Required range: 100 <= x <= 1000
Example:
500
details.video.settings.captionGrouping
enum<string>
required
How subtitle text is grouped: sentence chunks or one word at a time.
Available options:
chunked,
singleWord
Example:
"chunked"
details.video.settings.captionLinesPerBlock
integer
required
Lines a caption block may span when captionGrouping is chunked: 1, 2, or 3, or 0 for no limit, where blocks only break on pauses and sentence ends.
Required range: 0 <= x <= 3
Example:
1
details.video.settings.captionPosition
object | null
required
Normalized subtitle position, or null for automatic placement. Applies if subtitles are enabled on the video.
Hide child attributes
details.video.settings.captionPosition.x
number
required
Required range: 0 <= x <= 1
details.video.settings.captionPosition.y
number
required
Required range: 0 <= x <= 1
details.video.settings.captionSize
enum<string>
required
Subtitle text size. Applies if subtitles are enabled on the video.
Available options:
small,
medium,
large
Example:
"medium"
details.video.settings.captionStyle
Backdrop · object
required
Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.
Caption background color in #RRGGBB or #RRGGBBAA form. Its alpha channel is rendered exactly; #RRGGBB is fully opaque. Responses use uppercase #RRGGBBAA and report the effective rendered color.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#5E51F8FF"
details.video.settings.captionStyle.name
enum<string>
required
Available options:
backdrop
details.video.settings.captionStyle.textColor
string
required
Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.
Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.
Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.
Required range: 0 <= x <= 0.5
details.video.settings.captionStyle.shadowColor
string
Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#5E51F8FF"
details.video.settings.captionStyle.shadowEnabled
boolean
details.video.settings.captionStyle.textCase
enum<string>
Letter case applied to every caption word. Defaults to original.
Available options:
original,
uppercase,
lowercase
details.video.settings.captionsDefaultEnabled
boolean
required
Show subtitles to viewers by default
Example:
true
details.video.settings.commentEmailsEnabled
boolean
required
Send email notifications for new comments
Example:
false
details.video.settings.commentsEnabled
boolean
required
Allow viewers to comment
Example:
true
details.video.settings.creatorEnabled
boolean
required
Show who created the video on the video page
Example:
true
details.video.settings.cursor
object
required
Animated cursor settings
Hide child attributes
details.video.settings.cursor.clickRipple
boolean
required
Show a ripple on mouse clicks. Defaults off for new videos.
Example:
false
details.video.settings.cursor.hideWhenInactive
boolean
required
Fade the animated cursor out while inactive and back in when activity resumes.
Example:
false
details.video.settings.cursor.returnToStart
boolean
required
Move the cursor back to its opening position at the end for cleaner loops.
Example:
false
details.video.settings.cursor.size
number
required
Animated cursor size multiplier.
Required range: 0.5 <= x <= 6
Example:
3.05
details.video.settings.cursor.smoothing
boolean
required
Smooth cursor movement. Defaults off for new videos.
Example:
false
details.video.settings.cursor.style
enum<string>
required
Animated cursor artwork. mac is the pre-Tahoe style; macTahoe and macGoldenGate match those macOS generations; windows and touch use platform-specific artwork.
Available options:
mac,
macTahoe,
macGoldenGate,
windows,
touch
Example:
"macTahoe"
details.video.settings.cursor.tilt
boolean
required
Tilt the cursor in the direction it moves. Defaults off for new videos.
Example:
false
details.video.settings.cursor.tiltStrength
number
required
How far the cursor tilts while moving, from 0 (none) to 2 (maximum). Defaults to 0.5 for new videos. Only has an effect when tilt is true.
Required range: 0 <= x <= 2
Example:
0.5
details.video.settings.customThumbnailURL
string<uri> | null
required
Custom thumbnail image URL
Example:
"https://example.com/custom-thumbnail.jpg"
details.video.settings.defaultClipTransition
enum<string>
required
How each clip enters from the previous one, unless the clip overrides it via its own transition.
Available options:
smooth,
hard_cut
Example:
"hard_cut"
details.video.settings.defaultPlaybackRate
number
required
Default playback speed (0.5-2.0). Viewers can still adjust.
Required range: 0.5 <= x <= 2
Example:
1
details.video.settings.documentGenerationEnabled
boolean
required
Allow viewers to generate documents from the video (the Ask tab and POST /v1/videos/{id}/documents)
Example:
true
details.video.settings.downloadsEnabled
boolean
required
Allow viewers to download the video
Example:
true
details.video.settings.layoutAnimationStyle
enum<string>
required
How layout transitions animate, gentlest to snappiest. Zooms have their own zoomAnimationStyle. custom is a spring set outside the named styles.
Available options:
gentlest,
gentle,
relaxed,
smooth,
moderate,
brisk,
focused,
snappy,
punchy,
snappiest,
custom
Example:
"moderate"
details.video.settings.linkScope
enum<string>
required
Current access level, including org for workspace-visible videos
Available options:
public,
private,
org,
password,
embedonly
Example:
"org"
details.video.settings.microphoneVolume
number
required
Volume of the microphone (webcam) audio across the video. 1 is the recorded level, 0 mutes it, 2 doubles it. A clip can override it for one of its sources.
Required range: 0 <= x <= 2
Example:
1
details.video.settings.motionBlur
boolean
required
Blur fast zoom, pan, and cursor movement. Defaults on for new videos.
Where the button links, starting https:// or http://
Example:
"https://docs.tella.com/help"
details.video.settings.shrinkCameraDuringZooms
boolean
required
Shrink camera bubbles while a zoom is active. Defaults on.
Example:
true
details.video.settings.studioSound
boolean
required
Studio Sound (AI audio enhancement) master switch for the video. Individual clips can opt out via the clip's studioSound field.
Example:
false
details.video.settings.studioSoundLevel
enum<string>
required
Studio Sound level, as in the editor's Studio Voice panel: off, low or high.
Available options:
off,
low,
high
Example:
"off"
details.video.settings.subtitlesEnabled
boolean
required
Allow viewers to enable subtitles
Example:
true
details.video.settings.systemAudioVolume
number
required
Volume of the system/screen audio across the video — everything that is not microphone audio. 1 is the recorded level, 0 mutes it, 2 doubles it. A clip can override it for one of its sources.
Required range: 0 <= x <= 2
Example:
1
details.video.settings.thumbnailInpointMs
integer | null
required
Time in ms on the video's playback timeline of the frame picked as the thumbnail (set via inpointMs). Null when the thumbnail is an uploaded image or the default. A picked frame leaves customThumbnailURL null, so check this field to verify it.
Required range: 0 <= x <= 9007199254740991
Example:
12000
details.video.settings.transcriptsEnabled
boolean
required
Show transcript panel to viewers
Example:
true
details.video.settings.viewCountEnabled
boolean
required
Show view count on video page
Example:
true
details.video.settings.workspaceCallToAction
object | null
required
The workspace's default button (Settings → CTA button), shown when the video has no callToAction of its own. Read-only here.
Where the button links, starting https:// or http://
Example:
"https://docs.tella.com/help"
details.video.settings.zoomAnimationStyle
enum<string>
required
How zooms ease in, out, and between each other, gentlest to snappiest. Zooms follow layoutAnimationStyle until one is set. custom is a spring set outside the named styles.
Available options:
gentlest,
gentle,
relaxed,
smooth,
moderate,
brisk,
focused,
snappy,
punchy,
snappiest,
custom
Example:
"moderate"
details.video.settings.eyeContact
object
Eye contact correction: AI redirects the speaker's gaze to the camera lens in every camera recording. Only returned to callers who can edit the video, on the video itself (not the timeline).
Hide child attributes
details.video.settings.eyeContact.cameras
integer
required
Camera recordings in the video. Screen recordings and uploaded videos are never changed.
Required range: 0 <= x <= 9007199254740991
Example:
1
details.video.settings.eyeContact.camerasReady
integer
required
Camera recordings that have their corrected version
Required range: 0 <= x <= 9007199254740991
Example:
1
details.video.settings.eyeContact.enabled
boolean
required
Whether eye contact correction is on for the video
Example:
true
details.video.settings.eyeContact.status
enum<string>
required
processing while the last switch is being applied (cameras are being prepared, or it is turning off); ready once every camera has its corrected version; failed when it is on but some cameras couldn't be prepared (those keep their original look); off when it is off.
Available options:
off,
processing,
ready,
failed
Example:
"ready"
details.video.settings.keystrokes
object
The keystroke HUD, once someone has configured it on the video.
Hide child attributes
details.video.settings.keystrokes.alignment
enum<string>
required
Which horizontal edge of the HUD sits on position.x.
Available options:
left,
center,
right
Example:
"center"
details.video.settings.keystrokes.animation
object
required
How each chord enters and leaves. The text sides are always null.
Hide child attributes
details.video.settings.keystrokes.animation.intro
object | null
required
How the whole overlay enters, or null when it appears instantly.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
How long a chord lingers after its key is released, in milliseconds.
Required range: 300 <= x <= 10000
Example:
1000
details.video.settings.keystrokes.enabled
boolean
required
Show the HUD.
Example:
true
details.video.settings.keystrokes.filter
enum<string>
required
shortcuts shows only chords with a modifier, such as ⌘C or ⇧Tab, and hides typing, capitals and shifted symbols included; all also shows plain typing, including any text typed while recording.
Available options:
shortcuts,
all
Example:
"shortcuts"
details.video.settings.keystrokes.position
object
required
Anchor of the HUD as a fraction of the frame. alignment says which horizontal edge of the HUD sits on x.
Hide child attributes
details.video.settings.keystrokes.position.x
number
required
0 is the left edge.
Required range: 0 <= x <= 1
details.video.settings.keystrokes.position.y
number
required
0 is the top edge.
Required range: 0 <= x <= 1
details.video.settings.keystrokes.size
number
required
Size multiplier from 0.5 to 4 (1 is a 44 px cap on a 1080p frame).
Required range: 0.5 <= x <= 4
Example:
1
details.video.settings.keystrokes.style
enum<string>
required
keycap draws one rounded cap per key in a container; pill draws the chord as text in one box.
Available options:
keycap,
pill
Example:
"keycap"
details.video.settings.keystrokes.labels
enum<string>
The keyboard the keys are labelled for. Absent, each recording's own keyboard: ⌘ for the Mac app, Ctrl for Auto Capture takes. both shows a shortcut with Mac and Windows keys (⌘ C / Ctrl C).
Available options:
mac,
windows,
both
details.video.settings.keystrokes.typing
enum<string>
How filter: all shows plain typing. keys (the default when absent) shows one key per press; words grows a run of typing as text in one chip (backspace trims it; a pause, Return or a shortcut ends it), while shortcuts and keys pressed on their own still show as keys.
Available options:
keys,
words
Example:
"words"
details.video.settings.motionBlurAmount
number
Motion blur strength, 0.1 (subtle) to 2 (strong); 1 is the default. Absent while motion blur is off.
Example:
1
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"Tella","colors":{"primary":"#8278FA","light":"#B1AAFC","dark":"#5E51F8"},"logo":{"light":"https://mintcdn.com/tella/znRZoQ3e3rlGBTT2/logo-light.svg?fit=max\u0026auto=format\u0026n=znRZoQ3e3rlGBTT2\u0026q=85\u0026s=dd044b03efe593b53353a039bfb31fbf","dark":"https://mintcdn.com/tella/znRZoQ3e3rlGBTT2/logo-dark.svg?fit=max\u0026auto=format\u0026n=znRZoQ3e3rlGBTT2\u0026q=85\u0026s=88323f6b0165ce29c00e3a1d80c82fe3"},"favicon":"https://mintcdn.com/tella/munSRGpiNeMNXMvc/favicon.svg?fit=max\u0026auto=format\u0026n=munSRGpiNeMNXMvc\u0026q=85\u0026s=1b25a4dc5d9a41a1a9238eda432a0cb6","api":{"params":{"expanded":"all"},"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"all","prefill":true},"url":"full","mdx":{"auth":{"method":"bearer"}}},"navbar":{"primary":{"type":"button","label":"Open Tella","href":"https://www.tella.com/videos"}},"footer":{"socials":{"github":"https://github.com/tellahq","x":"https://x.com/tellahq","linkedin":"https://linkedin.com/company/tellahq","youtube":"https://youtube.com/@tellahq","website":"https://tella.com","instagram":"https://instagram.com/tellahq"},"links":[{"header":"Tella features","items":[{"label":"Video trimming","href":"https://www.tella.com/features/video-trimming"},{"label":"Viewer downloads","href":"https://www.tella.com/features/viewer-download"},{"label":"4K export","href":"https://www.tella.com/features/4k-export"},{"label":"AI editing","href":"https://www.tella.com/features/ai-editing"},{"label":"Custom branding","href":"https://www.tella.com/features/custom-branding"},{"label":"Upload video","href":"https://www.tella.com/features/video-upload"},{"label":"Video clips","href":"https://www.tella.com/features/clips"},{"label":"Custom backgrounds","href":"https://www.tella.com/features/custom-backgrounds"},{"label":"All features","href":"https://www.tella.com/features"}]}]},"seo":{"paths":[{"path":"help","metatags":{"canonical":"https://www.tella.com"}},{"path":"changelog","metatags":{"canonical":"https://www.tella.com"}}]},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":false},"contextual":{"options":["copy","assistant","view","chatgpt","claude","perplexity","grok","mcp","add-mcp","cursor","vscode"],"display":"header"},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"markdown":{"schema":true},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock-rotate-left","href":"/changelog"},{"anchor":"Community","icon":"users","href":"https://community.tella.tv"},{"anchor":"System Status","icon":"signal","href":"https://status.tella.com"},{"anchor":"Contact Support","icon":"envelope","href":"mailto:support@tella.com"},{"anchor":"Debug","icon":"bug","href":"/help/support/debug-camera-and-microphone-issues"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tella","hasAudioNarration":false,"actualSubdomain":"tella","customDomains":["www.tella.com"],"gitSource":{"type":"github","owner":"tellahq","repo":"tella-fusion","deployBranch":"main","contentDirectory":"packages/core/webapp/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"contextualFeedback":{"allowEmail":true},"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b00ef34c953c2aa6bb620f0","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Help Center","count":272},{"language":"default","tag":"Developers","count":216},{"language":"default","tag":"API Reference","count":163},{"language":"default","tag":"Edit","count":75},{"language":"default","tag":"Clips","count":63},{"language":"default","tag":"Share and embed","count":41},{"language":"default","tag":"Videos","count":40},{"language":"default","tag":"MCP Tools","count":35},{"language":"default","tag":"Troubleshooting and support","count":33},{"language":"default","tag":"Account and workspace","count":31}],"searchSettings":{"isFiltersEnabled":true,"maxResults":15,"showContentSnippets":true,"fullPageSearch":true}},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"type":"email","email":"support@tella.com","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/videos/get-a-videos-timeline","slug":"/api-reference/videos/get-a-videos-timeline","pageMetadata":{"title":"Get a video's timeline","description":"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.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/timeline","href":"/api-reference/videos/get-a-videos-timeline","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"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 \", _jsx(_components.code, {\n children: \"include\"\n }), \" to fetch specific video or clip details, optionally scoped by \", _jsx(_components.code, {\n children: \"clipIds\"\n }), \"; the complete outline remains in every response. Use \", _jsx(_components.code, {\n children: \"include=all\"\n }), \" 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.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Get a video's timeline","description":"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.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/timeline","href":"/api-reference/videos/get-a-videos-timeline","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/tella/0df50391d431fa00/support-chat.js","/docs/_mintlify/custom/tella/7e6fe091e3982139/lettervisit.js"],"openApiReferenceData":{"operation":{"description":"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.","operationId":"getVideoTimeline","parameters":["28afe198-f7d6-4427-aeaa-c88f796b5f20","1a9bcadc-178e-4792-bcb7-161c2ce75b50","0aa49060-e55a-47f3-b4a1-0873a17e69e0"],"responses":{"200":"de37424f-294d-439a-968c-756080281490","400":"020c7336-d205-43de-92be-73b73fce97dd","401":"9fc4c3fb-db85-4d9c-9ef0-f04bb9e81fef","403":"9dcdc045-779a-44a9-b903-a92623132708","404":"69f506b6-c82d-40a8-9bfd-460a8bb31a22","409":"0a1138ad-8e37-4151-ac8e-563a932ecf0c","429":"76dd6de1-c203-4ded-a3a8-8958baf5e1cb","500":"7d77e640-ffe2-4a74-8352-c4604e818347","501":"a2e176d6-bd73-4dc0-ae71-bf8af113e8ac","503":"185b58a5-a625-4ac9-9a5e-263bdf78c188"},"security":["f03f247d-f307-4f34-b215-b51e9e648392"],"summary":"Get a video's timeline","tags":["Videos"],"method":"get","type":"path","servers":["d2aabac2-b2bc-4b47-a6f4-a26614a56f79"],"path":"/v1/videos/{id}/timeline","baseUrlOptions":["https://api.tella.com"],"title":"Get a video's timeline","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[],"urlDisplay":"full"},"dependencies":{"parameters":{"28afe198-f7d6-4427-aeaa-c88f796b5f20":{"description":"Unique video identifier","in":"path","name":"id","required":true,"schema":{"description":"Unique video identifier","example":"vid_abc123def456","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"1a9bcadc-178e-4792-bcb7-161c2ce75b50":{"description":"Comma-separated clip IDs to return details for. The complete ordered clip outline is always returned.","in":"query","name":"clipIds","schema":{"description":"Comma-separated clip IDs to return details for. The complete ordered clip outline is always returned.","example":"scn_abc123,scn_def456","type":"string","uniqueKey":"","typeLabel":"string"}},"0aa49060-e55a-47f3-b4a1-0873a17e69e0":{"description":"Comma-separated details to include: all, settings, chapters, backgroundMusic, clipSettings, cuts, layouts, zooms, blurs, highlights, overlays, textOverlays, soundEffects, transcript, words. Default: none.","in":"query","name":"include","schema":{"description":"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","type":"string","uniqueKey":"","typeLabel":"string"}}},"responses":{"de37424f-294d-439a-968c-756080281490":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"A compact video timeline with optional video-level and clip-level details","properties":{"clips":{"description":"Complete clip outline in playback order","items":{"additionalProperties":false,"description":"A compact clip entry in the video's ordered timeline","properties":{"contents":{"additionalProperties":false,"properties":{"blurs":{"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"clips.items.[INDEX].contents.blurs","typeLabel":"integer"},"cuts":{"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"clips.items.[INDEX].contents.cuts","typeLabel":"integer"},"highlights":{"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"clips.items.[INDEX].contents.highlights","typeLabel":"integer"},"layouts":{"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"clips.items.[INDEX].contents.layouts","typeLabel":"integer"},"overlays":{"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"clips.items.[INDEX].contents.overlays","typeLabel":"integer"},"soundEffects":{"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"clips.items.[INDEX].contents.soundEffects","typeLabel":"integer"},"textOverlays":{"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"clips.items.[INDEX].contents.textOverlays","typeLabel":"integer"},"transcriptWords":{"oneOf":[{"description":"Number of transcript words on the clip playback timeline, including hidden words. Null when transcript data could not be read.","maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"clips.items.[INDEX].contents.transcriptWords.oneOf.0","typeLabel":"integer"},{"description":"Number of transcript words on the clip playback timeline, including hidden words. Null when transcript data could not be read.","maximum":9007199254740991,"minimum":0,"type":"null","isRequired":true,"uniqueKey":"clips.items.[INDEX].contents.transcriptWords.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"clips.items.[INDEX].contents.transcriptWords","typeLabel":"integer | null"},"zooms":{"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"clips.items.[INDEX].contents.zooms","typeLabel":"integer"}},"required":["cuts","layouts","zooms","blurs","highlights","overlays","textOverlays","soundEffects","transcriptWords"],"type":"object","isRequired":true,"uniqueKey":"clips.items.[INDEX].contents","typeLabel":"object"},"durationMs":{"description":"Clip playback duration in ms, with cuts removed","minimum":0,"type":"number","isRequired":true,"uniqueKey":"clips.items.[INDEX].durationMs","typeLabel":"number"},"id":{"type":"string","isRequired":true,"uniqueKey":"clips.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"clips.items.[INDEX].name","typeLabel":"string"},"order":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"clips.items.[INDEX].order","typeLabel":"integer"},"timelineStartMs":{"description":"Clip start time in ms on the complete video timeline","minimum":0,"type":"number","isRequired":true,"uniqueKey":"clips.items.[INDEX].timelineStartMs","typeLabel":"number"}},"required":["id","name","order","timelineStartMs","durationMs","contents"],"type":"object","uniqueKey":"clips.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"clips","typeLabel":"object[]"},"included":{"description":"Detail categories included in this response","items":{"enum":["settings","chapters","backgroundMusic","clipSettings","cuts","layouts","zooms","blurs","highlights","overlays","textOverlays","soundEffects","transcript","words"],"type":"string","uniqueKey":"included.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","isRequired":true,"uniqueKey":"included","typeLabel":"enum\u003cstring>[]"},"video":{"additionalProperties":false,"description":"Minimal video timeline summary","properties":{"aspectRatio":{"example":"16:9","type":"string","isRequired":true,"uniqueKey":"video.aspectRatio","typeLabel":"string"},"description":{"maxLength":5000,"type":"string","isRequired":true,"uniqueKey":"video.description","typeLabel":"string"},"dimensions":{"additionalProperties":false,"properties":{"height":{"description":"Canvas height in pixels","type":"number","isRequired":true,"uniqueKey":"video.dimensions.height","typeLabel":"number"},"width":{"description":"Canvas width in pixels","type":"number","isRequired":true,"uniqueKey":"video.dimensions.width","typeLabel":"number"}},"required":["width","height"],"type":"object","isRequired":true,"uniqueKey":"video.dimensions","typeLabel":"object"},"durationMs":{"description":"Total playback duration in ms","minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.durationMs","typeLabel":"number"},"id":{"type":"string","isRequired":true,"uniqueKey":"video.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"video.name","typeLabel":"string"},"updatedAt":{"description":"ISO-8601 timestamp of the video version represented","type":"string","isRequired":true,"uniqueKey":"video.updatedAt","typeLabel":"string"}},"required":["id","name","description","updatedAt","aspectRatio","dimensions","durationMs"],"type":"object","isRequired":true,"uniqueKey":"video","typeLabel":"object"},"details":{"type":"object","description":"Present only when at least one detail category is requested","properties":{"clips":{"items":{"additionalProperties":false,"description":"Only the explicitly requested detail fields are present","properties":{"clipId":{"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].clipId","typeLabel":"string"},"background":{"type":"object","description":"Clip background. Use type = 'solid' with `color`, type = 'image' or 'video' with `sourceId` (from `POST /v1/sources`) or an exact catalog URL from `GET /v1/backgrounds`, type = 'gradient' with `gradientColor1`, `gradientColor2`, `gradientAngle`, type = 'shaderGradient' with `shaderGradientPreset`, or type = 'ambient'.","required":["type"],"properties":{"type":{"description":"Background variant. `ambient`: the clip's screen, else its camera, heavily blurred; no other fields. `shaderGradient`: an animated gradient set by `shaderGradientPreset`; echoing a non-preset one unchanged keeps it.","enum":["solid","gradient","image","video","shaderGradient","ambient"],"example":"solid","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].background.type","typeLabel":"enum\u003cstring>"},"color":{"oneOf":[{"description":"Hex color string. Required when type = 'solid'.","example":"#000000ff","type":"string","uniqueKey":"details.clips.items.[INDEX].background.color.oneOf.0","typeLabel":"string"},{"description":"Hex color string. Required when type = 'solid'.","example":"#000000ff","type":"null","uniqueKey":"details.clips.items.[INDEX].background.color.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].background.color","typeLabel":"string | null"},"gradientAngle":{"oneOf":[{"description":"Linear gradient angle in degrees. Required when type = 'gradient'.","example":45,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","uniqueKey":"details.clips.items.[INDEX].background.gradientAngle.oneOf.0","typeLabel":"integer"},{"description":"Linear gradient angle in degrees. Required when type = 'gradient'.","example":45,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"null","uniqueKey":"details.clips.items.[INDEX].background.gradientAngle.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].background.gradientAngle","typeLabel":"integer | null"},"gradientColor1":{"oneOf":[{"description":"Hex color string. Required when type = 'gradient'.","example":"#ff0080ff","type":"string","uniqueKey":"details.clips.items.[INDEX].background.gradientColor1.oneOf.0","typeLabel":"string"},{"description":"Hex color string. Required when type = 'gradient'.","example":"#ff0080ff","type":"null","uniqueKey":"details.clips.items.[INDEX].background.gradientColor1.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].background.gradientColor1","typeLabel":"string | null"},"gradientColor2":{"oneOf":[{"description":"Hex color string. Required when type = 'gradient'.","example":"#7928caff","type":"string","uniqueKey":"details.clips.items.[INDEX].background.gradientColor2.oneOf.0","typeLabel":"string"},{"description":"Hex color string. Required when type = 'gradient'.","example":"#7928caff","type":"null","uniqueKey":"details.clips.items.[INDEX].background.gradientColor2.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].background.gradientColor2","typeLabel":"string | null"},"imageUrl":{"oneOf":[{"description":"Hosted image URL. Present in responses and accepted as input only when copied exactly from `GET /v1/backgrounds`; otherwise pass `sourceId`.","format":"uri","type":"string","uniqueKey":"details.clips.items.[INDEX].background.imageUrl.oneOf.0","typeLabel":"string\u003curi>"},{"description":"Hosted image URL. Present in responses and accepted as input only when copied exactly from `GET /v1/backgrounds`; otherwise pass `sourceId`.","format":"uri","type":"null","uniqueKey":"details.clips.items.[INDEX].background.imageUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].background.imageUrl","typeLabel":"string\u003curi> | null"},"shaderGradientPreset":{"oneOf":[{"description":"Animated gradient preset from `GET /v1/backgrounds`. Required when type = 'shaderGradient'.","example":"Halo","type":"string","uniqueKey":"details.clips.items.[INDEX].background.shaderGradientPreset.oneOf.0","typeLabel":"string"},{"description":"Animated gradient preset from `GET /v1/backgrounds`. Required when type = 'shaderGradient'.","example":"Halo","type":"null","uniqueKey":"details.clips.items.[INDEX].background.shaderGradientPreset.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].background.shaderGradientPreset","typeLabel":"string | null"},"sourceId":{"oneOf":[{"description":"Source ID from `POST /v1/sources` (`kind: image` for type = 'image', `kind: video` for type = 'video'). Required for image/video backgrounds unless using an exact URL from `GET /v1/backgrounds`. A video background source must have its file uploaded, be 20 MB or smaller, and not be an audio or auto capture source; it is also saved to your uploaded video backgrounds, like an upload in the editor. Input-only.","example":"su_abc123","type":"string","uniqueKey":"details.clips.items.[INDEX].background.sourceId.oneOf.0","typeLabel":"string"},{"description":"Source ID from `POST /v1/sources` (`kind: image` for type = 'image', `kind: video` for type = 'video'). Required for image/video backgrounds unless using an exact URL from `GET /v1/backgrounds`. A video background source must have its file uploaded, be 20 MB or smaller, and not be an audio or auto capture source; it is also saved to your uploaded video backgrounds, like an upload in the editor. Input-only.","example":"su_abc123","type":"null","uniqueKey":"details.clips.items.[INDEX].background.sourceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].background.sourceId","typeLabel":"string | null"},"videoDurationSeconds":{"oneOf":[{"description":"Video background duration in seconds. Read-only: derived from the uploaded source or catalog entry on input.","example":12.4,"minimum":0,"type":"number","uniqueKey":"details.clips.items.[INDEX].background.videoDurationSeconds.oneOf.0","typeLabel":"number"},{"description":"Video background duration in seconds. Read-only: derived from the uploaded source or catalog entry on input.","example":12.4,"minimum":0,"type":"null","uniqueKey":"details.clips.items.[INDEX].background.videoDurationSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].background.videoDurationSeconds","typeLabel":"number | null"},"videoUrl":{"oneOf":[{"description":"Hosted video URL. Present in responses and accepted as input only when copied exactly from `GET /v1/backgrounds`; otherwise pass `sourceId`.","format":"uri","type":"string","uniqueKey":"details.clips.items.[INDEX].background.videoUrl.oneOf.0","typeLabel":"string\u003curi>"},{"description":"Hosted video URL. Present in responses and accepted as input only when copied exactly from `GET /v1/backgrounds`; otherwise pass `sourceId`.","format":"uri","type":"null","uniqueKey":"details.clips.items.[INDEX].background.videoUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].background.videoUrl","typeLabel":"string\u003curi> | null"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].background","typeLabel":"object"},"blurs":{"items":{"additionalProperties":false,"description":"A blur or highlight mask on a clip. Times are in ms on the clip's playback timeline (cuts applied). Internally the mask stays anchored to the footage, so it doesn't drift when cuts change later.","properties":{"dimensions":{"additionalProperties":false,"description":"Size of the masked rectangle (percentages)","properties":{"heightPct":{"example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX].dimensions.heightPct","typeLabel":"number"},"widthPct":{"example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX].dimensions.widthPct","typeLabel":"number"}},"required":["widthPct","heightPct"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX].dimensions","typeLabel":"object"},"durationMs":{"example":2000,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX].durationMs","typeLabel":"number"},"id":{"description":"Mask ID","example":"ly_abc123","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX].id","typeLabel":"string"},"intensity":{"description":"Strength from 0 to 1. Blur: 0 is the standard blur and 1 blurs three times as heavily; the content stays fully hidden at every value (defaults to 0). Highlight: how dark the area outside the highlight goes, 0 = no dimming, 1 = black (defaults to 0.7).","example":0.7,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX].intensity","typeLabel":"number"},"point":{"additionalProperties":false,"description":"Top-left corner of the masked rectangle (percentages)","properties":{"xPct":{"example":25,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX].point.xPct","typeLabel":"number"},"yPct":{"example":25,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX].point.yPct","typeLabel":"number"}},"required":["xPct","yPct"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX].point","typeLabel":"object"},"startTimeMs":{"description":"Start time in ms on the clip's playback timeline (cuts applied)","example":1000,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX].startTimeMs","typeLabel":"number"},"transition":{"type":"string","description":"`smooth` fades the mask in and out, `hard_cut` pops it. New masks start on `hard_cut`.","enum":["smooth","hard_cut"],"example":"smooth","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX].transition","typeLabel":"enum\u003cstring>"},"type":{"enum":["blur","highlight"],"example":"blur","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"cornerRadius":{"description":"Corner radius from 0 to 64, in the clip's corner units (`regular` is the video's corner radius, 16 by default, and `squircle` twice that). Overrides the `corners` preset's radius, so it needs `corners` regular or squircle (in the request or already set); setting `corners` without it goes back to the preset's radius. Absent when the preset's radius applies.","example":24,"maximum":64,"minimum":0,"type":"number","uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX].cornerRadius","typeLabel":"number"},"corners":{"description":"How the highlighted area's corners are rounded. `auto` (the default) follows the clip's `corners`; the others override it for this highlight. Highlights only.","enum":["auto","none","regular","squircle"],"example":"regular","type":"string","uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX].corners","typeLabel":"enum\u003cstring>"}},"required":["id","type","startTimeMs","durationMs","point","dimensions","intensity","transition"],"type":"object","uniqueKey":"details.clips.items.[INDEX].blurs.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details.clips.items.[INDEX].blurs","typeLabel":"object[]"},"cuts":{"description":"Raw cut definitions in ms of the source recording, matching get_clip","items":{"additionalProperties":false,"description":"A range of the raw recording removed from playback. Cut definitions are the one place raw-recording coordinates appear: replacing the cut set describes the playback timeline you'd get after clearing all cuts. Cuts are always undoable — replace with `[]` to restore everything.","properties":{"durationMs":{"description":"Length of the cut, in milliseconds","example":750,"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].cuts.items.[INDEX].durationMs","typeLabel":"integer"},"startTimeMs":{"description":"Start of the cut, in ms of the raw recording","example":1500,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].cuts.items.[INDEX].startTimeMs","typeLabel":"integer"}},"required":["startTimeMs","durationMs"],"type":"object","uniqueKey":"details.clips.items.[INDEX].cuts.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details.clips.items.[INDEX].cuts","typeLabel":"object[]"},"highlights":{"items":{"additionalProperties":false,"description":"A blur or highlight mask on a clip. Times are in ms on the clip's playback timeline (cuts applied). Internally the mask stays anchored to the footage, so it doesn't drift when cuts change later.","properties":{"dimensions":{"additionalProperties":false,"description":"Size of the masked rectangle (percentages)","properties":{"heightPct":{"example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX].dimensions.heightPct","typeLabel":"number"},"widthPct":{"example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX].dimensions.widthPct","typeLabel":"number"}},"required":["widthPct","heightPct"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX].dimensions","typeLabel":"object"},"durationMs":{"example":2000,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX].durationMs","typeLabel":"number"},"id":{"description":"Mask ID","example":"ly_abc123","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX].id","typeLabel":"string"},"intensity":{"description":"Strength from 0 to 1. Blur: 0 is the standard blur and 1 blurs three times as heavily; the content stays fully hidden at every value (defaults to 0). Highlight: how dark the area outside the highlight goes, 0 = no dimming, 1 = black (defaults to 0.7).","example":0.7,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX].intensity","typeLabel":"number"},"point":{"additionalProperties":false,"description":"Top-left corner of the masked rectangle (percentages)","properties":{"xPct":{"example":25,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX].point.xPct","typeLabel":"number"},"yPct":{"example":25,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX].point.yPct","typeLabel":"number"}},"required":["xPct","yPct"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX].point","typeLabel":"object"},"startTimeMs":{"description":"Start time in ms on the clip's playback timeline (cuts applied)","example":1000,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX].startTimeMs","typeLabel":"number"},"transition":{"type":"string","description":"`smooth` fades the mask in and out, `hard_cut` pops it. New masks start on `hard_cut`.","enum":["smooth","hard_cut"],"example":"smooth","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX].transition","typeLabel":"enum\u003cstring>"},"type":{"enum":["blur","highlight"],"example":"blur","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"cornerRadius":{"description":"Corner radius from 0 to 64, in the clip's corner units (`regular` is the video's corner radius, 16 by default, and `squircle` twice that). Overrides the `corners` preset's radius, so it needs `corners` regular or squircle (in the request or already set); setting `corners` without it goes back to the preset's radius. Absent when the preset's radius applies.","example":24,"maximum":64,"minimum":0,"type":"number","uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX].cornerRadius","typeLabel":"number"},"corners":{"description":"How the highlighted area's corners are rounded. `auto` (the default) follows the clip's `corners`; the others override it for this highlight. Highlights only.","enum":["auto","none","regular","squircle"],"example":"regular","type":"string","uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX].corners","typeLabel":"enum\u003cstring>"}},"required":["id","type","startTimeMs","durationMs","point","dimensions","intensity","transition"],"type":"object","uniqueKey":"details.clips.items.[INDEX].highlights.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details.clips.items.[INDEX].highlights","typeLabel":"object[]"},"layoutSceneType":{"type":"string","description":"The clip's scene type, which decides the layouts it can use. Present when `clipSettings` or `layouts` is requested","enum":["basicSubject","cameraSubject","combi"],"example":"combi","uniqueKey":"details.clips.items.[INDEX].layoutSceneType","typeLabel":"enum\u003cstring>"},"layouts":{"items":{"additionalProperties":false,"description":"A layout attached to a clip. Times are in ms on the clip's playback timeline (cuts applied). Internally the layout stays anchored to the footage, so it doesn't drift when cuts change later.","properties":{"id":{"description":"Layout ID","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].id","typeLabel":"string"},"media":{"description":"B-roll media on this layout — one entry per filled slot (screen and/or camera). Empty on the base layout and on layouts whose underlying section carries no media. Each entry's `slot` says which slot it fills.","items":{"additionalProperties":false,"description":"Media on a layout, as returned in responses.","properties":{"type":{"enum":["image","video","motion"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"documentId":{"description":"The Tella Motion document (ffd_…) that `motion` media plays.","type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].documentId","typeLabel":"string"},"height":{"oneOf":[{"description":"Image height in pixels (image media only).","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].height.oneOf.0","typeLabel":"integer"},{"description":"Image height in pixels (image media only).","maximum":9007199254740991,"minimum":-9007199254740991,"type":"null","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].height.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].height","typeLabel":"integer | null"},"imageUrl":{"oneOf":[{"description":"Hosted image URL, for image media. Read-only: not accepted as input — pass `sourceId` instead.","type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].imageUrl.oneOf.0","typeLabel":"string"},{"description":"Hosted image URL, for image media. Read-only: not accepted as input — pass `sourceId` instead.","type":"null","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].imageUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].imageUrl","typeLabel":"string | null"},"muted":{"oneOf":[{"description":"True when video media plays with its own audio silenced.","type":"boolean","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].muted.oneOf.0","typeLabel":"boolean"},{"description":"True when video media plays with its own audio silenced.","type":"null","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].muted.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].muted","typeLabel":"boolean | null"},"slot":{"description":"Which slot the media fills: `screen` (the subject/main frame, the default) or `camera` (the bubble/presentation slot — a media bubble over the recording behind it). A `camera` slot requires a layout that renders the camera (e.g. camera-bubble, side-by-side, tv-presenter).","enum":["screen","camera"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].slot","typeLabel":"enum\u003cstring>"},"sourceId":{"oneOf":[{"description":"Source ID the media was created from. Absent for image media added in the editor.","type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].sourceId.oneOf.0","typeLabel":"string"},{"description":"Source ID the media was created from. Absent for image media added in the editor.","type":"null","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].sourceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].sourceId","typeLabel":"string | null"},"startTimeMs":{"oneOf":[{"description":"Video media only: where it starts in its source, in ms. Absent when it plays from the start.","type":"number","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].startTimeMs.oneOf.0","typeLabel":"number"},{"description":"Video media only: where it starts in its source, in ms. Absent when it plays from the start.","type":"null","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].startTimeMs.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].startTimeMs","typeLabel":"number | null"},"width":{"oneOf":[{"description":"Image width in pixels (image media only).","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].width.oneOf.0","typeLabel":"integer"},{"description":"Image width in pixels (image media only).","maximum":9007199254740991,"minimum":-9007199254740991,"type":"null","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].width.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX].width","typeLabel":"integer | null"}},"required":["type"],"type":"object","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].media","typeLabel":"object[]"},"cameraStyle":{"description":"The camera's frame shape, as the editor's Camera style picker sets it, overriding the named layout's own: `circle`, `square`, `portrait`, `none` (a rectangle in the camera slot's aspect, rounded by the clip's `corners`, e.g. a squircle when corners are `squircle`), `cutout` (the presenter cut out of the camera feed with no frame), `blob` or `blob-outline`. It shapes the camera bubble and the pop-out frame. Absent when the layout's own shape applies; custom layouts report it as `presentation.shape` instead.","enum":["none","circle","square","portrait","cutout","blob","blob-outline"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].cameraStyle","typeLabel":"enum\u003cstring>"},"crop":{"oneOf":[{"type":"object","description":"The crop of the clip's screen recording while this layout shows — the layout's own crop, else the clip's. Absent when the recording is uncropped.","required":["top","right","bottom","left"],"properties":{"bottom":{"description":"Pixels of the screen recording removed from its bottom edge","minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].crop.oneOf.0.bottom","typeLabel":"number"},"left":{"description":"Pixels of the screen recording removed from its left edge","minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].crop.oneOf.0.left","typeLabel":"number"},"right":{"description":"Pixels of the screen recording removed from its right edge","minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].crop.oneOf.0.right","typeLabel":"number"},"top":{"description":"Pixels of the screen recording removed from its top edge","minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].crop.oneOf.0.top","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].crop.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].crop.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].crop","typeLabel":"object | null"},"durationMs":{"oneOf":[{"description":"Layout duration in ms. Omitted for clip-spanning layouts.","example":5000,"minimum":0,"type":"number","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].durationMs.oneOf.0","typeLabel":"number"},{"description":"Layout duration in ms. Omitted for clip-spanning layouts.","example":5000,"minimum":0,"type":"null","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].durationMs.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].durationMs","typeLabel":"number | null"},"followsBase":{"description":"True when this layout follows the clip's base layout: updating the `base` layout changes it too, so it needs no update of its own. False when it has its own layout. Absent on the base layout itself.","type":"boolean","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].followsBase","typeLabel":"boolean"},"layout":{"oneOf":[{"type":"object","title":"Fullscreen","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind"],"properties":{"kind":{"enum":["fullscreen"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"screenFit":{"description":"Only honoured for basic-subject clips (Tella renders the screen fullscreen). Defaults to cover.","enum":["cover","letterbox"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.0.screenFit","typeLabel":"enum\u003cstring>"},"style":{"description":"`regular` (default) is plain fullscreen; `stretch` punches in to 1.15x. On basic-subject clips `stretch` needs uploaded footage (not a screen recording).","enum":["regular","stretch"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.0.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.0","typeLabel":"Fullscreen · object"},{"type":"object","title":"Middle","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind"],"properties":{"kind":{"enum":["middle"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.1.kind","typeLabel":"enum\u003cstring>"},"shape":{"description":"Required for camera-subject clips. Rejected on basic-subject clips, which have no camera.","enum":["circle","square","landscape","portrait"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.1.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.1","typeLabel":"Middle · object"},{"type":"object","title":"Side by Side","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind","position","style"],"properties":{"kind":{"enum":["side-by-side"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.2.kind","typeLabel":"enum\u003cstring>"},"position":{"description":"Where the camera sits. `left`/`right` on landscape clips; `top`/`bottom` on portrait and square clips.","enum":["left","right","top","bottom"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.2.position","typeLabel":"enum\u003cstring>"},"style":{"description":"`regular` weights camera and screen unevenly, `even` splits 50/50, `overlap` lets the camera bleed over the screen edge (and requires `size`), `perspective` angles the camera and screen toward each other (landscape only). Portrait and square clips support `even` only. `regular` and `overlap` scale the whole screen recording to fit its panel; `even` fills each half edge to edge and center-crops the screen to that half-canvas box (roughly half its width on a landscape canvas), with no `screenFit`/letterbox option. Avoid `even` for terminals, code, spreadsheets or other dense screen content unless you check the result with a clip frame. In the editor's layout picker these are 'Split Left/Right' (regular), 'Split Left/Right Overlap' (overlap, size M or L), 'Split Left/Right Small' (overlap, size S) and 'Split Left/Right 50/50' (even); users often call Overlap 'overlay'.","enum":["regular","even","overlap","perspective"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.2.style","typeLabel":"enum\u003cstring>"},"size":{"description":"Camera size. Required when `style: \"overlap\"`; ignored otherwise.","enum":["S","M","L"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.2.size","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.2","typeLabel":"Side by Side · object"},{"type":"object","title":"TV Presenter","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind","position","style"],"properties":{"kind":{"enum":["tv-presenter"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.3.kind","typeLabel":"enum\u003cstring>"},"position":{"enum":["left","right"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.3.position","typeLabel":"enum\u003cstring>"},"style":{"description":"`regular` is the standard today-show framing, `full` puts the screen fullscreen behind the presenter, `overlap` tightens the camera-screen overlap.","enum":["regular","full","overlap"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.3.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.3","typeLabel":"TV Presenter · object"},{"type":"object","title":"Cut Out","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind"],"properties":{"kind":{"enum":["cut-out"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.4.kind","typeLabel":"enum\u003cstring>"},"position":{"description":"Combi clips only (required there): which side the cut-out presenter sits on in landscape. Portrait and square stories stack the two instead — `right` puts the presenter at the top, `left` at the bottom. Ignored on camera-subject clips.","enum":["left","right"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.4.position","typeLabel":"enum\u003cstring>"},"style":{"description":"Landscape combi clips only. `regular` (default) places the screen beside the presenter; `perspective` fills most of the canvas with the screen, angled away toward the presenter, who stands in front in the bottom corner on `position`'s side.","enum":["regular","perspective"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.4.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.4","typeLabel":"Cut Out · object"},{"type":"object","title":"Camera Bubble","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind","position","size"],"properties":{"kind":{"enum":["camera-bubble"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.5.kind","typeLabel":"enum\u003cstring>"},"position":{"enum":["left","right","top","bottom","top-left","top-right","bottom-left","bottom-right","middle"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.5.position","typeLabel":"enum\u003cstring>"},"size":{"enum":["S","M","L"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.5.size","typeLabel":"enum\u003cstring>"},"screenFit":{"description":"Only honoured when `style: \"full\"`. Defaults to cover.","enum":["cover","letterbox"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.5.screenFit","typeLabel":"enum\u003cstring>"},"shape":{"description":"Defaults to `circle`, as in the editor's Camera Bubble picker.","enum":["circle","square","landscape","portrait"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.5.shape","typeLabel":"enum\u003cstring>"},"style":{"description":"`regular` (default) keeps the screen layered behind the bubble; `full` puts the screen fullscreen behind the bubble (and honours `screenFit`).","enum":["regular","full"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.5.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.5","typeLabel":"Camera Bubble · object"},{"type":"object","title":"Camera Only","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind","style"],"properties":{"kind":{"enum":["camera-only"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.6.kind","typeLabel":"enum\u003cstring>"},"style":{"description":"`fullscreen` fills the frame with the camera (optional `punchIn`); `middle` centers a shaped camera (requires `shape`).","enum":["fullscreen","middle"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.6.style","typeLabel":"enum\u003cstring>"},"punchIn":{"description":"Only allowed when `style: \"fullscreen\"`; `punchIn: true` with `style: \"middle\"` is rejected. Defaults to false.","type":"boolean","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.6.punchIn","typeLabel":"boolean"},"shape":{"description":"Required when `style: \"middle\"`, rejected otherwise. Allowed shapes vary by ratio (no `portrait` in portrait clips, no `square` in square clips).","enum":["circle","square","landscape","portrait"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.6.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.6","typeLabel":"Camera Only · object"},{"type":"object","title":"Screen Only","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind","style"],"properties":{"kind":{"enum":["screen-only"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.7.kind","typeLabel":"enum\u003cstring>"},"style":{"description":"`fullscreen` fills the frame with the screen (optional `screenFit`); `middle` centers the screen.","enum":["fullscreen","middle"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.7.style","typeLabel":"enum\u003cstring>"},"screenFit":{"description":"Only honoured when `style: \"fullscreen\"`. Defaults to cover.","enum":["cover","letterbox"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.7.screenFit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.7","typeLabel":"Screen Only · object"},{"type":"object","title":"Custom","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind"],"properties":{"kind":{"enum":["custom"],"type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.kind","typeLabel":"enum\u003cstring>"},"presentation":{"type":"object","description":"The camera on combi clips. When omitted on a clip that has a camera and no custom geometry yet, the camera is kept but hidden.","properties":{"corners":{"description":"Corner rounding of a rectangular frame. Defaults to `regular`.","enum":["none","regular","squircle"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.presentation.corners","typeLabel":"enum\u003cstring>"},"dimensions":{"type":"object","description":"Slot size in artboard pixels.","required":["width","height"],"properties":{"height":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.presentation.dimensions.height","typeLabel":"number"},"width":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.presentation.dimensions.width","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.presentation.dimensions","typeLabel":"object"},"hidden":{"description":"Leave the layer out of the picture. Defaults to false.","type":"boolean","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.presentation.hidden","typeLabel":"boolean"},"order":{"description":"Stacking order; the lower one draws on top: 0 is the front layer and 1 the layer behind it (use only 0 and 1). Defaults to 0 for the subject and 1 for the presentation.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.presentation.order","typeLabel":"integer"},"point":{"type":"object","description":"Top-left corner of the slot in artboard pixels.","required":["x","y"],"properties":{"x":{"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.presentation.point.x","typeLabel":"number"},"y":{"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.presentation.point.y","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.presentation.point","typeLabel":"object"},"shape":{"description":"Frame the layer is drawn in: `none` (default) is the plain rectangle given by `dimensions`; `circle`, `square` and `portrait` are the camera-bubble frames; `cutout` cuts the presenter out of the camera feed; `blob` is a wobbling bubble that grows toward the presenter's hands, and `blob-outline` is the same with a white line around it.","enum":["none","circle","square","portrait","cutout","blob","blob-outline"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.presentation.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.presentation","typeLabel":"object"},"subject":{"type":"object","description":"The main layer: the screen recording on combi and basic-subject clips, the camera on camera-subject clips. A screen keeps its recording's aspect ratio: `dimensions` are fitted to it around the same centre.","properties":{"corners":{"description":"Corner rounding of a rectangular frame. Defaults to `regular`.","enum":["none","regular","squircle"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.subject.corners","typeLabel":"enum\u003cstring>"},"dimensions":{"type":"object","description":"Slot size in artboard pixels.","required":["width","height"],"properties":{"height":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.subject.dimensions.height","typeLabel":"number"},"width":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.subject.dimensions.width","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.subject.dimensions","typeLabel":"object"},"hidden":{"description":"Leave the layer out of the picture. Defaults to false.","type":"boolean","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.subject.hidden","typeLabel":"boolean"},"order":{"description":"Stacking order; the lower one draws on top: 0 is the front layer and 1 the layer behind it (use only 0 and 1). Defaults to 0 for the subject and 1 for the presentation.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.subject.order","typeLabel":"integer"},"point":{"type":"object","description":"Top-left corner of the slot in artboard pixels.","required":["x","y"],"properties":{"x":{"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.subject.point.x","typeLabel":"number"},"y":{"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.subject.point.y","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.subject.point","typeLabel":"object"},"shape":{"description":"Frame the layer is drawn in: `none` (default) is the plain rectangle given by `dimensions`; `circle`, `square` and `portrait` are the camera-bubble frames; `cutout` cuts the presenter out of the camera feed; `blob` is a wobbling bubble that grows toward the presenter's hands, and `blob-outline` is the same with a white line around it.","enum":["none","circle","square","portrait","cutout","blob","blob-outline"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.subject.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8.subject","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.8","typeLabel":"Custom · object"},{"type":"null","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout.oneOf.9","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].layout","typeLabel":"Fullscreen · object | Middle · object | Side by Side · object | TV Presenter · object | Cut Out · object | Camera Bubble · object | Camera Only · object | Screen Only · object | Custom · object | null"},"popOut":{"oneOf":[{"type":"object","description":"The camera's pop-out while this layout shows. Absent when it is off.","properties":{"amount":{"description":"How far the frame shrinks below the presenter, as a fraction of the camera slot (0–0.5). Defaults to 0.22.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].popOut.oneOf.0.amount","typeLabel":"number"},"background":{"description":"What fills the frame behind the presenter: `original` keeps the camera feed, `color` paints `color`. Defaults to `original`.","enum":["original","color"],"type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].popOut.oneOf.0.background","typeLabel":"enum\u003cstring>"},"color":{"description":"Frame fill when `background` is `color`, as #RRGGBB or #RRGGBBAA. Defaults to #6366F1.","pattern":"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$","type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].popOut.oneOf.0.color","typeLabel":"string"},"outlineColor":{"description":"Outline colour as #RRGGBB or #RRGGBBAA. Defaults to #FFFFFF.","pattern":"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$","type":"string","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].popOut.oneOf.0.outlineColor","typeLabel":"string"},"outlineWidth":{"description":"Outline around the frame as a fraction of its width (0–0.05); 0 draws none. Defaults to 0.","maximum":0.05,"minimum":0,"type":"number","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].popOut.oneOf.0.outlineWidth","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].popOut.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].popOut.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].popOut","typeLabel":"object | null"},"startTimeMs":{"oneOf":[{"description":"Layout start time in ms on the clip's playback timeline (cuts applied). Omitted for clip-spanning layouts.","example":0,"minimum":0,"type":"number","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].startTimeMs.oneOf.0","typeLabel":"number"},{"description":"Layout start time in ms on the clip's playback timeline (cuts applied). Omitted for clip-spanning layouts.","example":0,"minimum":0,"type":"null","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].startTimeMs.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].startTimeMs","typeLabel":"number | null"},"transitionStyle":{"oneOf":[{"type":"string","title":"LayoutTransitionStyle","description":"Transition into this layout. Omitted on the base layout, or when the section uses an internal style not exposed via the public API.","enum":["spring","hardCut"],"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].transitionStyle.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].transitionStyle.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX].transitionStyle","typeLabel":"enum\u003cstring> | null"}},"required":["id","media"],"type":"object","uniqueKey":"details.clips.items.[INDEX].layouts.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details.clips.items.[INDEX].layouts","typeLabel":"object[]"},"microphoneVolume":{"oneOf":[{"description":"Clip microphone volume override: a number when overridden, null when following the video, absent when there is no microphone audio","maximum":2,"minimum":0,"type":"number","uniqueKey":"details.clips.items.[INDEX].microphoneVolume.oneOf.0","typeLabel":"number"},{"description":"Clip microphone volume override: a number when overridden, null when following the video, absent when there is no microphone audio","maximum":2,"minimum":0,"type":"null","uniqueKey":"details.clips.items.[INDEX].microphoneVolume.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].microphoneVolume","typeLabel":"number | null"},"overlays":{"items":{"additionalProperties":false,"description":"An image, video or Tella Motion overlay on a clip.","properties":{"animation":{"oneOf":[{"type":"object","description":"How the overlay enters and leaves, or null when it plays its `transition`.","required":["intro","outro","textIntro","textOutro","motionBlur"],"properties":{"intro":{"oneOf":[{"type":"object","description":"How the whole overlay enters, or null when it appears instantly.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.intro","typeLabel":"object | null"},"motionBlur":{"description":"Blur the overlay along its motion while it moves, scales or turns.","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.motionBlur","typeLabel":"boolean"},"outro":{"oneOf":[{"type":"object","description":"How the whole overlay leaves, or null when it disappears instantly.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.outro","typeLabel":"object | null"},"textIntro":{"oneOf":[{"type":"object","description":"How a text overlay's letters, words or lines enter, one after another, while `intro` plays on the whole box. Null when they don't.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textIntro","typeLabel":"object | null"},"textOutro":{"oneOf":[{"type":"object","description":"How a text overlay's letters, words or lines leave, one after another, while `outro` plays on the whole box. Null when they don't.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0.textOutro","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].animation","typeLabel":"object | null"},"depth":{"description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].depth","typeLabel":"enum\u003cstring>"},"dimensions":{"additionalProperties":false,"description":"Overlay size in artboard pixels. Absolute (not a percentage) so the overlay shape never distorts when the artboard dimensions change. Both sides must be greater than 0 — the renderer lays the overlay out into this box, so a zero or negative side has no valid meaning.","properties":{"height":{"example":540,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].dimensions.height","typeLabel":"number"},"width":{"example":960,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].dimensions.width","typeLabel":"number"}},"required":["width","height"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].dimensions","typeLabel":"object"},"durationMs":{"example":5000,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].durationMs","typeLabel":"number"},"id":{"description":"Overlay ID","example":"ly_abc123","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].id","typeLabel":"string"},"point":{"additionalProperties":false,"description":"Top-left corner of the overlay, as a percentage of the video canvas (0-100). Relative so the anchor survives video aspect ratio changes.","properties":{"xPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].point.xPct","typeLabel":"number"},"yPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].point.yPct","typeLabel":"number"}},"required":["xPct","yPct"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].point","typeLabel":"object"},"startTimeMs":{"description":"Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.","example":1000,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].startTimeMs","typeLabel":"number"},"transition":{"type":"string","description":"Intro/outro animation: `smooth` fades the overlay in at its start and out at its end, `hard_cut` pops it in and out. New overlays start on `hard_cut`. An `animation` replaces it while set.","enum":["smooth","hard_cut"],"example":"hard_cut","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].transition","typeLabel":"enum\u003cstring>"},"type":{"description":"`motion` plays a Tella Motion document of the video's live (`motionDocumentId`).","enum":["image","video","motion"],"example":"image","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"zIndex":{"description":"Stacking position among the clip's image, video and text overlays: 0 is the backmost. `depth` applies first — a `behind_presenter` overlay stays behind the presenter whatever its zIndex — so the order only matters among overlays at the same depth. Lottie overlays share the stack but aren't listed, so listed values can skip a number.","example":0,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].zIndex","typeLabel":"integer"},"depthChanges":{"type":"array","items":{"additionalProperties":false,"properties":{"atMs":{"description":"Ms after the overlay starts.","example":1200,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].depthChanges.items.[INDEX].atMs","typeLabel":"number"},"depth":{"description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].depthChanges.items.[INDEX].depth","typeLabel":"enum\u003cstring>"}},"required":["atMs","depth"],"type":"object","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].depthChanges.items.[INDEX]","typeLabel":"object"},"description":"Changes of `depth` over the overlay's own time, each held until the next: `atMs` after the overlay starts it moves to that depth, so one overlay can pass in front of the presenter and back behind them (a ring orbiting their head, a title they step in front of). `depth` is where it starts. On updates, omit it to leave the changes as they are; `[]` removes them. Absent in responses while the overlay holds one depth.","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].depthChanges","typeLabel":"object[]"},"imageUrl":{"oneOf":[{"description":"Hosted image URL, for image overlays. Read-only: not accepted as input — pass `sourceId` instead.","type":"string","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].imageUrl.oneOf.0","typeLabel":"string"},{"description":"Hosted image URL, for image overlays. Read-only: not accepted as input — pass `sourceId` instead.","type":"null","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].imageUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].imageUrl","typeLabel":"string | null"},"motionDocumentId":{"description":"The Tella Motion document (ffd_…) a `motion` overlay plays. Edit it with `POST /v1/motion/documents/{id}/commands`.","example":"ffd_abc123","type":"string","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].motionDocumentId","typeLabel":"string"},"name":{"oneOf":[{"example":"Logo","type":"string","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"example":"Logo","type":"null","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].name","typeLabel":"string | null"},"sourceId":{"oneOf":[{"description":"Source ID the overlay was created from.","example":"su_abc123","type":"string","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].sourceId.oneOf.0","typeLabel":"string"},{"description":"Source ID the overlay was created from.","example":"su_abc123","type":"null","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].sourceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX].sourceId","typeLabel":"string | null"}},"required":["id","type","startTimeMs","durationMs","point","dimensions","transition","depth","zIndex","animation"],"type":"object","uniqueKey":"details.clips.items.[INDEX].overlays.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details.clips.items.[INDEX].overlays","typeLabel":"object[]"},"soundEffects":{"items":{"additionalProperties":false,"description":"A sound effect on a clip.","properties":{"durationMs":{"example":3000,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].soundEffects.items.[INDEX].durationMs","typeLabel":"number"},"id":{"description":"Sound effect ID","example":"ly_abc123","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].soundEffects.items.[INDEX].id","typeLabel":"string"},"startTimeMs":{"description":"Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.","example":1000,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].soundEffects.items.[INDEX].startTimeMs","typeLabel":"number"},"volume":{"description":"Playback volume (1 = original).","example":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].soundEffects.items.[INDEX].volume","typeLabel":"number"},"name":{"oneOf":[{"example":"Whoosh","type":"string","uniqueKey":"details.clips.items.[INDEX].soundEffects.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"example":"Whoosh","type":"null","uniqueKey":"details.clips.items.[INDEX].soundEffects.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].soundEffects.items.[INDEX].name","typeLabel":"string | null"},"sourceId":{"oneOf":[{"example":"su_abc123","type":"string","uniqueKey":"details.clips.items.[INDEX].soundEffects.items.[INDEX].sourceId.oneOf.0","typeLabel":"string"},{"example":"su_abc123","type":"null","uniqueKey":"details.clips.items.[INDEX].soundEffects.items.[INDEX].sourceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].soundEffects.items.[INDEX].sourceId","typeLabel":"string | null"}},"required":["id","startTimeMs","durationMs","volume"],"type":"object","uniqueKey":"details.clips.items.[INDEX].soundEffects.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details.clips.items.[INDEX].soundEffects","typeLabel":"object[]"},"studioSound":{"description":"Effective Studio Sound state: the video-level switch minus this clip's opt-out","type":"boolean","uniqueKey":"details.clips.items.[INDEX].studioSound","typeLabel":"boolean"},"systemAudioVolume":{"oneOf":[{"description":"Clip system audio override: a number when overridden, null when following the video, absent when there is no system audio","maximum":2,"minimum":0,"type":"number","uniqueKey":"details.clips.items.[INDEX].systemAudioVolume.oneOf.0","typeLabel":"number"},{"description":"Clip system audio override: a number when overridden, null when following the video, absent when there is no system audio","maximum":2,"minimum":0,"type":"null","uniqueKey":"details.clips.items.[INDEX].systemAudioVolume.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].systemAudioVolume","typeLabel":"number | null"},"textOverlays":{"items":{"additionalProperties":false,"description":"A text overlay on a clip. Unlike image and video overlays it references no source — the copy and its font live on the overlay itself.","properties":{"animation":{"oneOf":[{"type":"object","description":"How the text enters and leaves, or null when it plays its `transition`.","required":["intro","outro","textIntro","textOutro","motionBlur"],"properties":{"intro":{"oneOf":[{"type":"object","description":"How the whole overlay enters, or null when it appears instantly.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.intro","typeLabel":"object | null"},"motionBlur":{"description":"Blur the overlay along its motion while it moves, scales or turns.","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.motionBlur","typeLabel":"boolean"},"outro":{"oneOf":[{"type":"object","description":"How the whole overlay leaves, or null when it disappears instantly.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.outro","typeLabel":"object | null"},"textIntro":{"oneOf":[{"type":"object","description":"How a text overlay's letters, words or lines enter, one after another, while `intro` plays on the whole box. Null when they don't.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textIntro","typeLabel":"object | null"},"textOutro":{"oneOf":[{"type":"object","description":"How a text overlay's letters, words or lines leave, one after another, while `outro` plays on the whole box. Null when they don't.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0.textOutro","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].animation","typeLabel":"object | null"},"background":{"type":"object","description":"Background behind the text. Overlays with no visible box report a solid #00000000.","required":["type","color"],"properties":{"color":{"description":"Hex color string. Required when type = 'solid'. Transparent backgrounds use #00000000.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].background.color","typeLabel":"string"},"type":{"description":"Background variant. Text overlays take a solid background; the other `ClipBackground` variants are not supported behind text.","enum":["solid"],"example":"solid","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].background.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].background","typeLabel":"object"},"backgroundPadding":{"description":"Extra room around the text inside its background, as a fraction of the font size added on every side (0.5 at an 80px font adds 40px). 0 is the standard padding. No effect without a visible background.","example":0.25,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].backgroundPadding","typeLabel":"number"},"backgroundShape":{"description":"Shape of the solid background behind the text.","enum":["none","regular","squircle"],"example":"squircle","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].backgroundShape","typeLabel":"enum\u003cstring>"},"color":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#FFFFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].color","typeLabel":"string"},"cornerRadius":{"oneOf":[{"type":"number","description":"The background's own corner radius in story pixels, or null for its shape's.","maximum":512,"minimum":0,"example":24,"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].cornerRadius.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].cornerRadius.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].cornerRadius","typeLabel":"number | null"},"depth":{"description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].depth","typeLabel":"enum\u003cstring>"},"dimensions":{"additionalProperties":false,"description":"Overlay size in artboard pixels. Absolute (not a percentage) so the overlay shape never distorts when the artboard dimensions change. Both sides must be greater than 0 — the renderer lays the overlay out into this box, so a zero or negative side has no valid meaning.","properties":{"height":{"example":540,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].dimensions.height","typeLabel":"number"},"width":{"example":960,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].dimensions.width","typeLabel":"number"}},"required":["width","height"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].dimensions","typeLabel":"object"},"durationMs":{"example":5000,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].durationMs","typeLabel":"number"},"fontFamily":{"description":"The overlay's font family. Normally one of the catalog families accepted on write, or a library font's family when `fontId` is set. Overlays created before that catalog can report another bundled family, such as `Graphik`.","example":"Inter","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].fontFamily","typeLabel":"string"},"fontSize":{"description":"Font size in artboard pixels — absolute, like `dimensions`, so text keeps its size relative to the frame. Renderers scale it by their render scale factor.","example":81,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].fontSize","typeLabel":"number"},"fontWeight":{"description":"Variable-font weight axis — 100 (thin) to 900 (black).","example":500,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].fontWeight","typeLabel":"number"},"fontWidth":{"description":"Variable-font width axis, as a percentage — 100 is normal, 50 ultra-condensed, 150 extra-expanded.","example":100,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].fontWidth","typeLabel":"number"},"id":{"description":"Text overlay ID","example":"ly_abc123","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].id","typeLabel":"string"},"letterSpacing":{"description":"Tracking: space between letters, as a fraction of the font size (-0.05 at an 80px font pulls letters 4px closer; 0.1 spreads them 8px apart). Negative tightens; 0 is the font's own spacing.","example":-0.02,"maximum":1,"minimum":-0.2,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].letterSpacing","typeLabel":"number"},"lineHeight":{"description":"Distance between baselines, as a multiple of the font size (1.5 at an 80px font puts lines 120px apart). 1.2 is the standard spacing.","example":1.5,"maximum":3,"minimum":0.8,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].lineHeight","typeLabel":"number"},"outline":{"oneOf":[{"description":"Color of the outline (stroke) drawn around the letters, or null for no outline.","example":"#000000FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].outline.oneOf.0","typeLabel":"string"},{"description":"Color of the outline (stroke) drawn around the letters, or null for no outline.","example":"#000000FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"null","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].outline.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].outline","typeLabel":"string | null"},"point":{"additionalProperties":false,"description":"Top-left corner of the overlay, as a percentage of the video canvas (0-100). Relative so the anchor survives video aspect ratio changes.","properties":{"xPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].point.xPct","typeLabel":"number"},"yPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].point.yPct","typeLabel":"number"}},"required":["xPct","yPct"],"type":"object","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].point","typeLabel":"object"},"shadow":{"description":"Drop shadow, matching the editor's Shadow menu. It falls from the background box when the text has one, else from the letters.","enum":["none","subtle","deep"],"example":"subtle","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].shadow","typeLabel":"enum\u003cstring>"},"startTimeMs":{"description":"Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.","example":1000,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].startTimeMs","typeLabel":"number"},"text":{"example":"Welcome back","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].text","typeLabel":"string"},"textAlign":{"description":"Horizontal alignment of the text inside its overlay box.","enum":["left","center","right"],"example":"center","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].textAlign","typeLabel":"enum\u003cstring>"},"transition":{"type":"string","description":"Intro/outro animation: `smooth` fades the text in at its start and out at its end, `hard_cut` pops it in and out. New text overlays start on `hard_cut`. An `animation` replaces it while set.","enum":["smooth","hard_cut"],"example":"hard_cut","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].transition","typeLabel":"enum\u003cstring>"},"zIndex":{"description":"Stacking position among the clip's image, video and text overlays: 0 is the backmost. `depth` applies first — a `behind_presenter` overlay stays behind the presenter whatever its zIndex — so the order only matters among overlays at the same depth. Lottie overlays share the stack but aren't listed, so listed values can skip a number.","example":0,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].zIndex","typeLabel":"integer"},"depthChanges":{"type":"array","items":{"additionalProperties":false,"properties":{"atMs":{"description":"Ms after the overlay starts.","example":1200,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].depthChanges.items.[INDEX].atMs","typeLabel":"number"},"depth":{"description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].depthChanges.items.[INDEX].depth","typeLabel":"enum\u003cstring>"}},"required":["atMs","depth"],"type":"object","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].depthChanges.items.[INDEX]","typeLabel":"object"},"description":"Changes of `depth` over the overlay's own time, each held until the next: `atMs` after the overlay starts it moves to that depth, so one overlay can pass in front of the presenter and back behind them (a ring orbiting their head, a title they step in front of). `depth` is where it starts. On updates, omit it to leave the changes as they are; `[]` removes them. Absent in responses while the overlay holds one depth.","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].depthChanges","typeLabel":"object[]"},"fontId":{"description":"The library font the overlay renders with (a `font` item's id), absent for a catalog family.","example":"media_abc123def456","type":"string","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX].fontId","typeLabel":"string"}},"required":["id","text","fontFamily","fontSize","color","fontWeight","fontWidth","textAlign","background","backgroundShape","outline","backgroundPadding","letterSpacing","lineHeight","cornerRadius","shadow","startTimeMs","durationMs","point","dimensions","transition","depth","zIndex","animation"],"type":"object","uniqueKey":"details.clips.items.[INDEX].textOverlays.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details.clips.items.[INDEX].textOverlays","typeLabel":"object[]"},"transcript":{"oneOf":[{"type":"object","description":"Null when the clip has no speech or its transcript is unavailable","required":["text","wordCount"],"properties":{"text":{"description":"Visible transcript text","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].transcript.oneOf.0.text","typeLabel":"string"},"wordCount":{"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].transcript.oneOf.0.wordCount","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].transcript.oneOf.0","typeLabel":"object"},{"type":"null","description":"Null when the clip has no speech or its transcript is unavailable","required":["text","wordCount"],"properties":{"text":{"description":"Visible transcript text","type":"string"},"wordCount":{"maximum":9007199254740991,"minimum":0,"type":"integer"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].transcript.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].transcript","typeLabel":"object | null"},"words":{"oneOf":[{"description":"Words in ms on the clip playback timeline. Includes hidden words so indices remain usable with transcript editing endpoints. Null when transcript data could not be read.","items":{"additionalProperties":false,"description":"A single transcribed word","properties":{"breakAfter":{"description":"Whether a subtitle break is forced after this word, so the next word always starts a new subtitle block","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].words.oneOf.0.items.[INDEX].breakAfter","typeLabel":"boolean"},"endTimeMs":{"description":"Word end time, in ms on the clip's playback timeline","example":1800,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].words.oneOf.0.items.[INDEX].endTimeMs","typeLabel":"number"},"hidden":{"description":"Whether the word is hidden by an edit","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].words.oneOf.0.items.[INDEX].hidden","typeLabel":"boolean"},"index":{"description":"Stable index of the word in the source recording","example":12,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].words.oneOf.0.items.[INDEX].index","typeLabel":"integer"},"keepWithNext":{"description":"Whether this word's subtitle block is kept together with the next word across punctuation and pauses. The lines-per-block limit still applies and `breakAfter` wins.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].words.oneOf.0.items.[INDEX].keepWithNext","typeLabel":"boolean"},"startTimeMs":{"description":"Word start time, in ms on the clip's playback timeline","example":1500,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].words.oneOf.0.items.[INDEX].startTimeMs","typeLabel":"number"},"text":{"description":"Word text","example":"Hello","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].words.oneOf.0.items.[INDEX].text","typeLabel":"string"}},"required":["index","startTimeMs","endTimeMs","text","hidden","breakAfter","keepWithNext"],"type":"object","uniqueKey":"details.clips.items.[INDEX].words.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details.clips.items.[INDEX].words.oneOf.0","typeLabel":"object[]"},{"description":"Words in ms on the clip playback timeline. Includes hidden words so indices remain usable with transcript editing endpoints. Null when transcript data could not be read.","items":{"additionalProperties":false,"description":"A single transcribed word","properties":{"breakAfter":{"description":"Whether a subtitle break is forced after this word, so the next word always starts a new subtitle block","example":false,"type":"boolean"},"endTimeMs":{"description":"Word end time, in ms on the clip's playback timeline","example":1800,"minimum":0,"type":"number"},"hidden":{"description":"Whether the word is hidden by an edit","example":false,"type":"boolean"},"index":{"description":"Stable index of the word in the source recording","example":12,"maximum":9007199254740991,"minimum":0,"type":"integer"},"keepWithNext":{"description":"Whether this word's subtitle block is kept together with the next word across punctuation and pauses. The lines-per-block limit still applies and `breakAfter` wins.","example":false,"type":"boolean"},"startTimeMs":{"description":"Word start time, in ms on the clip's playback timeline","example":1500,"minimum":0,"type":"number"},"text":{"description":"Word text","example":"Hello","type":"string"}},"required":["index","startTimeMs","endTimeMs","text","hidden","breakAfter","keepWithNext"],"type":"object"},"type":"null","uniqueKey":"details.clips.items.[INDEX].words.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].words","typeLabel":"object[] | null"},"zooms":{"items":{"additionalProperties":false,"description":"A zoom effect applied to the footage in the clip's Screen slot — the screen recording, or b-roll media a layout puts there (the camera is unaffected). Use `manualZoom` with a `focusPoint`, or `trackingZoom` to follow the cursor automatically. Times are in ms on the clip's playback timeline (cuts applied). Internally the zoom stays anchored to the footage, so it doesn't drift when cuts change later.","properties":{"durationMs":{"description":"Duration in ms of playback. 0 when the zoom's footage is entirely cut out.","example":2000,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX].durationMs","typeLabel":"number"},"id":{"description":"Zoom ID","example":"ef_abc123","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX].id","typeLabel":"string"},"introTransition":{"type":"string","description":"How the zoom enters: `smooth` (the default) animates in, `hard_cut` jumps straight in.","enum":["smooth","hard_cut"],"example":"hard_cut","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX].introTransition","typeLabel":"enum\u003cstring>"},"outroTransition":{"type":"string","description":"How the zoom leaves: `smooth` (the default) animates out, `hard_cut` jumps straight back.","enum":["smooth","hard_cut"],"example":"smooth","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX].outroTransition","typeLabel":"enum\u003cstring>"},"startTimeMs":{"description":"Start time in ms on the clip's playback timeline (cuts applied)","example":1000,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX].startTimeMs","typeLabel":"number"},"type":{"description":"`manualZoom` zooms into a fixed `focusPoint` on the screen. `trackingZoom` automatically follows the cursor in the screen recording.","enum":["manualZoom","trackingZoom"],"example":"manualZoom","type":"string","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"focusPoint":{"oneOf":[{"type":"object","description":"Point on the zoomed footage to zoom into, expressed as percentages of its dimensions. Required for `manualZoom`; ignored for `trackingZoom`.","required":["xPct","yPct"],"properties":{"xPct":{"description":"Horizontal position on the screen frame (0-100). 0 = left edge.","example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX].focusPoint.oneOf.0.xPct","typeLabel":"number"},"yPct":{"description":"Vertical position on the screen frame (0-100). 0 = top edge.","example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX].focusPoint.oneOf.0.yPct","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX].focusPoint.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX].focusPoint.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX].focusPoint","typeLabel":"object | null"},"scale":{"oneOf":[{"description":"Magnification factor (1 = no zoom, 3.5 = max).","example":2,"maximum":3.5,"minimum":1,"type":"number","uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX].scale.oneOf.0","typeLabel":"number"},{"description":"Magnification factor (1 = no zoom, 3.5 = max).","example":2,"maximum":3.5,"minimum":1,"type":"null","uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX].scale.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX].scale","typeLabel":"number | null"}},"required":["id","type","startTimeMs","durationMs","introTransition","outroTransition"],"type":"object","uniqueKey":"details.clips.items.[INDEX].zooms.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details.clips.items.[INDEX].zooms","typeLabel":"object[]"}},"required":["clipId"],"type":"object","uniqueKey":"details.clips.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details.clips","typeLabel":"object[]"},"video":{"type":"object","properties":{"backgroundMusic":{"oneOf":[{"type":"object","description":"One video-wide track that loops over the whole video and is included in exports","required":["url","durationMs","volume","name"],"properties":{"durationMs":{"description":"Audio track duration in milliseconds","example":180036,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.video.backgroundMusic.oneOf.0.durationMs","typeLabel":"number"},"name":{"oneOf":[{"description":"Optional display name for the track","example":"Calm Product Tour","type":"string","isRequired":true,"uniqueKey":"details.video.backgroundMusic.oneOf.0.name.oneOf.0","typeLabel":"string"},{"description":"Optional display name for the track","example":"Calm Product Tour","type":"null","isRequired":true,"uniqueKey":"details.video.backgroundMusic.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.backgroundMusic.oneOf.0.name","typeLabel":"string | null"},"url":{"description":"HTTPS URL of the audio track","example":"https://ucarecdn.com/example-track/","format":"uri","pattern":"^https:\\/\\/.*","type":"string","isRequired":true,"uniqueKey":"details.video.backgroundMusic.oneOf.0.url","typeLabel":"string\u003curi>"},"volume":{"description":"Track volume from 0 (silent) to 1 (full volume)","example":0.2,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.video.backgroundMusic.oneOf.0.volume","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.video.backgroundMusic.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"details.video.backgroundMusic.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.video.backgroundMusic","typeLabel":"object | null"},"chapters":{"items":{"additionalProperties":false,"description":"A chapter/section within a video","properties":{"description":{"description":"Chapter description","example":"Overview of what we'll cover","maxLength":5000,"type":"string","isRequired":true,"uniqueKey":"details.video.chapters.items.[INDEX].description","typeLabel":"string"},"timestampSeconds":{"description":"Chapter start time in seconds","example":0,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.video.chapters.items.[INDEX].timestampSeconds","typeLabel":"number"},"title":{"description":"Chapter title","example":"Introduction","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"details.video.chapters.items.[INDEX].title","typeLabel":"string"}},"required":["title","description","timestampSeconds"],"type":"object","uniqueKey":"details.video.chapters.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details.video.chapters","typeLabel":"object[]"},"settings":{"type":"object","description":"Video playback and access settings","required":["defaultPlaybackRate","captionsDefaultEnabled","subtitlesEnabled","captionStyle","captionSize","captionGrouping","captionPosition","captionFontFamily","captionFontWeight","captionFontSize","captionLinesPerBlock","transcriptsEnabled","documentGenerationEnabled","creatorEnabled","publishDateEnabled","viewCountEnabled","commentsEnabled","commentEmailsEnabled","downloadsEnabled","rawDownloadsEnabled","linkScope","searchEngineIndexingEnabled","allowedEmbedDomains","customThumbnailURL","thumbnailInpointMs","studioSound","studioSoundLevel","defaultClipTransition","microphoneVolume","systemAudioVolume","motionBlur","shrinkCameraDuringZooms","layoutAnimationStyle","zoomAnimationStyle","cursor","callToAction","secondaryCallToAction","workspaceCallToAction","workspaceSecondaryCallToAction","callToActionsHidden"],"properties":{"allowedEmbedDomains":{"description":"Restrict embedding to these domains only (Premium feature). Empty array allows all domains.","example":["example.com","mysite.org"],"items":{"type":"string","uniqueKey":"details.video.settings.allowedEmbedDomains.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"details.video.settings.allowedEmbedDomains","typeLabel":"string[]"},"callToAction":{"oneOf":[{"type":"object","description":"The video's own call-to-action button on its share page. null when it has none, in which case `workspaceCallToAction` shows instead.","required":["label","url"],"properties":{"label":{"description":"Button text","maxLength":100,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"details.video.settings.callToAction.oneOf.0.label","typeLabel":"string"},"url":{"description":"Where the button links, starting https:// or http://","example":"https://docs.tella.com/help","type":"string","isRequired":true,"uniqueKey":"details.video.settings.callToAction.oneOf.0.url","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.callToAction.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.video.settings.callToAction.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.callToAction","typeLabel":"object | null"},"callToActionsHidden":{"description":"Every call-to-action button is hidden on the share page, the workspace defaults included.","type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.callToActionsHidden","typeLabel":"boolean"},"captionFontFamily":{"description":"Subtitle font family. On write, one of Tella's catalog font families or the built-in subtitle families `Dela Gothic One`, `Lato`, `Georgia`, and `Arial`, or the video's current family to keep an uploaded font. Reads report the family the subtitles render with.","example":"Inter","minLength":1,"type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionFontFamily","typeLabel":"string"},"captionFontSize":{"description":"Exact subtitle text size, 40 to 200 — the editor's Size slider. `captionSize` is the same setting in buckets (small 40, medium 64, large 80), so a request passes one or the other, not both.","example":64,"maximum":200,"minimum":40,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.captionFontSize","typeLabel":"number"},"captionFontWeight":{"description":"Subtitle font weight, 100 (thin) to 1000. Catalog fonts clamp to their supported range; built-in subtitle fonts outside the catalog snap to an available weight. `Dela Gothic One` uses 400 only; `Arial` uses 400 or 700. Reads report the weight that renders. Sent without `captionFontFamily`, it re-weights the video's current font.","example":500,"maximum":1000,"minimum":100,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.captionFontWeight","typeLabel":"number"},"captionGrouping":{"description":"How subtitle text is grouped: sentence chunks or one word at a time.","enum":["chunked","singleWord"],"example":"chunked","type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionGrouping","typeLabel":"enum\u003cstring>"},"captionLinesPerBlock":{"description":"Lines a caption block may span when `captionGrouping` is `chunked`: 1, 2, or 3, or 0 for no limit, where blocks only break on pauses and sentence ends.","example":1,"maximum":3,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.video.settings.captionLinesPerBlock","typeLabel":"integer"},"captionPosition":{"oneOf":[{"type":"object","description":"Normalized subtitle position, or null for automatic placement. Applies if subtitles are enabled on the video.","required":["x","y"],"properties":{"x":{"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.captionPosition.oneOf.0.x","typeLabel":"number"},"y":{"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.captionPosition.oneOf.0.y","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.captionPosition.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.video.settings.captionPosition.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.captionPosition","typeLabel":"object | null"},"captionSize":{"description":"Subtitle text size. Applies if subtitles are enabled on the video.","enum":["small","medium","large"],"example":"medium","type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionSize","typeLabel":"enum\u003cstring>"},"captionStyle":{"oneOf":[{"type":"object","title":"Backdrop","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["backgroundColor","name","textColor","wordLevelHighlights"],"properties":{"backgroundColor":{"description":"Caption background color in #RRGGBB or #RRGGBBAA form. Its alpha channel is rendered exactly; #RRGGBB is fully opaque. Responses use uppercase #RRGGBBAA and report the effective rendered color.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.0.backgroundColor","typeLabel":"string"},"name":{"enum":["backdrop"],"type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.0.name","typeLabel":"enum\u003cstring>"},"textColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.0.textColor","typeLabel":"string"},"wordLevelHighlights":{"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.0.wordLevelHighlights","typeLabel":"boolean"},"activeWordTextColor":{"description":"Text color of the spoken word when highlightMode is background. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.0.activeWordTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.0.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.0.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.0.backgroundBorderWidth","typeLabel":"number"},"backgroundEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.0.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.0.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.0.backgroundRadius","typeLabel":"number"},"highlightColor":{"description":"Spoken-word color. Omit to retain the legacy text-opacity progression.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.0.highlightColor","typeLabel":"string"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to text.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.0.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.0.maxWidth","typeLabel":"number"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.0.outlineColor","typeLabel":"string"},"outlineEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.0.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.0.outlineWidth","typeLabel":"number"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.0.shadowColor","typeLabel":"string"},"shadowEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.0.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.0.textCase","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.0","typeLabel":"Backdrop · object"},{"type":"object","title":"Highlight","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["name","primaryTextColor","secondaryTextColor","highlightColor"],"properties":{"highlightColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.1.highlightColor","typeLabel":"string"},"name":{"enum":["highlight"],"type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.1.name","typeLabel":"enum\u003cstring>"},"primaryTextColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.1.primaryTextColor","typeLabel":"string"},"secondaryTextColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.1.secondaryTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.1.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.1.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.1.backgroundBorderWidth","typeLabel":"number"},"backgroundColor":{"description":"Caption background color in #RRGGBB or #RRGGBBAA form. Its alpha channel is rendered exactly; #RRGGBB is fully opaque. Responses use uppercase #RRGGBBAA and report the effective rendered color.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.1.backgroundColor","typeLabel":"string"},"backgroundEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.1.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.1.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.1.backgroundRadius","typeLabel":"number"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to background.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.1.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.1.maxWidth","typeLabel":"number"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.1.outlineColor","typeLabel":"string"},"outlineEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.1.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.1.outlineWidth","typeLabel":"number"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.1.shadowColor","typeLabel":"string"},"shadowEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.1.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.1.textCase","typeLabel":"enum\u003cstring>"},"wordLevelHighlights":{"description":"Highlight each word as it is spoken. Defaults to true.","type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.1.wordLevelHighlights","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.1","typeLabel":"Highlight · object"},{"type":"object","title":"Mono","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["name","textColor","highlightColor"],"properties":{"highlightColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.2.highlightColor","typeLabel":"string"},"name":{"enum":["mono"],"type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.2.name","typeLabel":"enum\u003cstring>"},"textColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.2.textColor","typeLabel":"string"},"activeWordTextColor":{"description":"Text color of the spoken word when highlightMode is background. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.2.activeWordTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.2.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.2.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.2.backgroundBorderWidth","typeLabel":"number"},"backgroundColor":{"description":"Caption background color in #RRGGBB or #RRGGBBAA form. Its alpha channel is rendered exactly; #RRGGBB is fully opaque. Responses use uppercase #RRGGBBAA and report the effective rendered color.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.2.backgroundColor","typeLabel":"string"},"backgroundEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.2.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.2.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.2.backgroundRadius","typeLabel":"number"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to text.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.2.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.2.maxWidth","typeLabel":"number"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.2.outlineColor","typeLabel":"string"},"outlineEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.2.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.2.outlineWidth","typeLabel":"number"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.2.shadowColor","typeLabel":"string"},"shadowEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.2.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.2.textCase","typeLabel":"enum\u003cstring>"},"wordLevelHighlights":{"description":"Highlight each word as it is spoken. Defaults to true.","type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.2.wordLevelHighlights","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.2","typeLabel":"Mono · object"},{"type":"object","title":"Cannes","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["shadowColor","name","textColor"],"properties":{"name":{"enum":["cannes"],"type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.3.name","typeLabel":"enum\u003cstring>"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.3.shadowColor","typeLabel":"string"},"textColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.3.textColor","typeLabel":"string"},"activeWordTextColor":{"description":"Text color of the spoken word when highlightMode is background. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.3.activeWordTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.3.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.3.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.3.backgroundBorderWidth","typeLabel":"number"},"backgroundColor":{"description":"Caption background color in #RRGGBB or #RRGGBBAA form. Its alpha channel is rendered exactly; #RRGGBB is fully opaque. Responses use uppercase #RRGGBBAA and report the effective rendered color.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.3.backgroundColor","typeLabel":"string"},"backgroundEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.3.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.3.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.3.backgroundRadius","typeLabel":"number"},"highlightColor":{"description":"Spoken-word color. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.3.highlightColor","typeLabel":"string"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to text.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.3.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.3.maxWidth","typeLabel":"number"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.3.outlineColor","typeLabel":"string"},"outlineEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.3.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.3.outlineWidth","typeLabel":"number"},"shadowEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.3.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.3.textCase","typeLabel":"enum\u003cstring>"},"wordLevelHighlights":{"description":"Highlight each word as it is spoken. Defaults to false.","type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.3.wordLevelHighlights","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.3","typeLabel":"Cannes · object"},{"type":"object","title":"Classic","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["outlineColor","name","textColor"],"properties":{"name":{"enum":["classic"],"type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.4.name","typeLabel":"enum\u003cstring>"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.4.outlineColor","typeLabel":"string"},"textColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.4.textColor","typeLabel":"string"},"activeWordTextColor":{"description":"Text color of the spoken word when highlightMode is background. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.4.activeWordTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.4.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.4.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.4.backgroundBorderWidth","typeLabel":"number"},"backgroundColor":{"description":"Caption background color in #RRGGBB or #RRGGBBAA form. Its alpha channel is rendered exactly; #RRGGBB is fully opaque. Responses use uppercase #RRGGBBAA and report the effective rendered color.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.4.backgroundColor","typeLabel":"string"},"backgroundEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.4.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.4.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.4.backgroundRadius","typeLabel":"number"},"highlightColor":{"description":"Spoken-word color. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.4.highlightColor","typeLabel":"string"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to text.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.4.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.4.maxWidth","typeLabel":"number"},"outlineEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.4.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"details.video.settings.captionStyle.oneOf.4.outlineWidth","typeLabel":"number"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.4.shadowColor","typeLabel":"string"},"shadowEnabled":{"type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.4.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"details.video.settings.captionStyle.oneOf.4.textCase","typeLabel":"enum\u003cstring>"},"wordLevelHighlights":{"description":"Highlight each word as it is spoken. Defaults to false.","type":"boolean","uniqueKey":"details.video.settings.captionStyle.oneOf.4.wordLevelHighlights","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.captionStyle.oneOf.4","typeLabel":"Classic · object"}],"isRequired":true,"uniqueKey":"details.video.settings.captionStyle","typeLabel":"Backdrop · object | Highlight · object | Mono · object | Cannes · object | Classic · object"},"captionsDefaultEnabled":{"description":"Show subtitles to viewers by default","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.captionsDefaultEnabled","typeLabel":"boolean"},"commentEmailsEnabled":{"description":"Send email notifications for new comments","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.commentEmailsEnabled","typeLabel":"boolean"},"commentsEnabled":{"description":"Allow viewers to comment","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.commentsEnabled","typeLabel":"boolean"},"creatorEnabled":{"description":"Show who created the video on the video page","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.creatorEnabled","typeLabel":"boolean"},"cursor":{"additionalProperties":false,"description":"Animated cursor settings","properties":{"clickRipple":{"description":"Show a ripple on mouse clicks. Defaults off for new videos.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.cursor.clickRipple","typeLabel":"boolean"},"hideWhenInactive":{"description":"Fade the animated cursor out while inactive and back in when activity resumes.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.cursor.hideWhenInactive","typeLabel":"boolean"},"returnToStart":{"description":"Move the cursor back to its opening position at the end for cleaner loops.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.cursor.returnToStart","typeLabel":"boolean"},"size":{"description":"Animated cursor size multiplier.","example":3.05,"maximum":6,"minimum":0.5,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.cursor.size","typeLabel":"number"},"smoothing":{"description":"Smooth cursor movement. Defaults off for new videos.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.cursor.smoothing","typeLabel":"boolean"},"style":{"description":"Animated cursor artwork. mac is the pre-Tahoe style; macTahoe and macGoldenGate match those macOS generations; windows and touch use platform-specific artwork.","enum":["mac","macTahoe","macGoldenGate","windows","touch"],"example":"macTahoe","type":"string","isRequired":true,"uniqueKey":"details.video.settings.cursor.style","typeLabel":"enum\u003cstring>"},"tilt":{"description":"Tilt the cursor in the direction it moves. Defaults off for new videos.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.cursor.tilt","typeLabel":"boolean"},"tiltStrength":{"description":"How far the cursor tilts while moving, from 0 (none) to 2 (maximum). Defaults to 0.5 for new videos. Only has an effect when tilt is true.","example":0.5,"maximum":2,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.cursor.tiltStrength","typeLabel":"number"}},"required":["style","size","smoothing","tilt","tiltStrength","clickRipple","hideWhenInactive","returnToStart"],"type":"object","isRequired":true,"uniqueKey":"details.video.settings.cursor","typeLabel":"object"},"customThumbnailURL":{"oneOf":[{"description":"Custom thumbnail image URL","example":"https://example.com/custom-thumbnail.jpg","format":"uri","type":"string","isRequired":true,"uniqueKey":"details.video.settings.customThumbnailURL.oneOf.0","typeLabel":"string\u003curi>"},{"description":"Custom thumbnail image URL","example":"https://example.com/custom-thumbnail.jpg","format":"uri","type":"null","isRequired":true,"uniqueKey":"details.video.settings.customThumbnailURL.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.customThumbnailURL","typeLabel":"string\u003curi> | null"},"defaultClipTransition":{"type":"string","description":"How each clip enters from the previous one, unless the clip overrides it via its own `transition`.","enum":["smooth","hard_cut"],"example":"hard_cut","isRequired":true,"uniqueKey":"details.video.settings.defaultClipTransition","typeLabel":"enum\u003cstring>"},"defaultPlaybackRate":{"description":"Default playback speed (0.5-2.0). Viewers can still adjust.","example":1,"maximum":2,"minimum":0.5,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.defaultPlaybackRate","typeLabel":"number"},"documentGenerationEnabled":{"description":"Allow viewers to generate documents from the video (the Ask tab and POST /v1/videos/{id}/documents)","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.documentGenerationEnabled","typeLabel":"boolean"},"downloadsEnabled":{"description":"Allow viewers to download the video","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.downloadsEnabled","typeLabel":"boolean"},"layoutAnimationStyle":{"description":"How layout transitions animate, gentlest to snappiest. Zooms have their own `zoomAnimationStyle`. `custom` is a spring set outside the named styles.","enum":["gentlest","gentle","relaxed","smooth","moderate","brisk","focused","snappy","punchy","snappiest","custom"],"example":"moderate","type":"string","isRequired":true,"uniqueKey":"details.video.settings.layoutAnimationStyle","typeLabel":"enum\u003cstring>"},"linkScope":{"type":"string","description":"Current access level, including `org` for workspace-visible videos","enum":["public","private","org","password","embedonly"],"example":"org","isRequired":true,"uniqueKey":"details.video.settings.linkScope","typeLabel":"enum\u003cstring>"},"microphoneVolume":{"description":"Volume of the microphone (webcam) audio across the video. 1 is the recorded level, 0 mutes it, 2 doubles it. A clip can override it for one of its sources.","example":1,"maximum":2,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.microphoneVolume","typeLabel":"number"},"motionBlur":{"description":"Blur fast zoom, pan, and cursor movement. Defaults on for new videos.","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.motionBlur","typeLabel":"boolean"},"publishDateEnabled":{"description":"Show publish date on video page","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.publishDateEnabled","typeLabel":"boolean"},"rawDownloadsEnabled":{"description":"Allow viewers to download raw source files","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.rawDownloadsEnabled","typeLabel":"boolean"},"searchEngineIndexingEnabled":{"description":"Allow search engines to index the video page","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.searchEngineIndexingEnabled","typeLabel":"boolean"},"secondaryCallToAction":{"oneOf":[{"type":"object","description":"The video's own second button, next to `callToAction`. null when it has none, in which case `workspaceSecondaryCallToAction` shows instead.","required":["label","url"],"properties":{"label":{"description":"Button text","maxLength":100,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"details.video.settings.secondaryCallToAction.oneOf.0.label","typeLabel":"string"},"url":{"description":"Where the button links, starting https:// or http://","example":"https://docs.tella.com/help","type":"string","isRequired":true,"uniqueKey":"details.video.settings.secondaryCallToAction.oneOf.0.url","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.secondaryCallToAction.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.video.settings.secondaryCallToAction.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.secondaryCallToAction","typeLabel":"object | null"},"shrinkCameraDuringZooms":{"description":"Shrink camera bubbles while a zoom is active. Defaults on.","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.shrinkCameraDuringZooms","typeLabel":"boolean"},"studioSound":{"description":"Studio Sound (AI audio enhancement) master switch for the video. Individual clips can opt out via the clip's `studioSound` field.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.studioSound","typeLabel":"boolean"},"studioSoundLevel":{"description":"Studio Sound level, as in the editor's Studio Voice panel: `off`, `low` or `high`.","enum":["off","low","high"],"example":"off","type":"string","isRequired":true,"uniqueKey":"details.video.settings.studioSoundLevel","typeLabel":"enum\u003cstring>"},"subtitlesEnabled":{"description":"Allow viewers to enable subtitles","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.subtitlesEnabled","typeLabel":"boolean"},"systemAudioVolume":{"description":"Volume of the system/screen audio across the video — everything that is not microphone audio. 1 is the recorded level, 0 mutes it, 2 doubles it. A clip can override it for one of its sources.","example":1,"maximum":2,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.systemAudioVolume","typeLabel":"number"},"thumbnailInpointMs":{"oneOf":[{"description":"Time in ms on the video's playback timeline of the frame picked as the thumbnail (set via `inpointMs`). Null when the thumbnail is an uploaded image or the default. A picked frame leaves `customThumbnailURL` null, so check this field to verify it.","example":12000,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.video.settings.thumbnailInpointMs.oneOf.0","typeLabel":"integer"},{"description":"Time in ms on the video's playback timeline of the frame picked as the thumbnail (set via `inpointMs`). Null when the thumbnail is an uploaded image or the default. A picked frame leaves `customThumbnailURL` null, so check this field to verify it.","example":12000,"maximum":9007199254740991,"minimum":0,"type":"null","isRequired":true,"uniqueKey":"details.video.settings.thumbnailInpointMs.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.thumbnailInpointMs","typeLabel":"integer | null"},"transcriptsEnabled":{"description":"Show transcript panel to viewers","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.transcriptsEnabled","typeLabel":"boolean"},"viewCountEnabled":{"description":"Show view count on video page","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.viewCountEnabled","typeLabel":"boolean"},"workspaceCallToAction":{"oneOf":[{"type":"object","description":"The workspace's default button (Settings → CTA button), shown when the video has no `callToAction` of its own. Read-only here.","required":["label","url"],"properties":{"label":{"description":"Button text","maxLength":100,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"details.video.settings.workspaceCallToAction.oneOf.0.label","typeLabel":"string"},"url":{"description":"Where the button links, starting https:// or http://","example":"https://docs.tella.com/help","type":"string","isRequired":true,"uniqueKey":"details.video.settings.workspaceCallToAction.oneOf.0.url","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.workspaceCallToAction.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.video.settings.workspaceCallToAction.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.workspaceCallToAction","typeLabel":"object | null"},"workspaceSecondaryCallToAction":{"oneOf":[{"type":"object","description":"The workspace's default second button, shown when the video has no `secondaryCallToAction` of its own. Read-only here.","required":["label","url"],"properties":{"label":{"description":"Button text","maxLength":100,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"details.video.settings.workspaceSecondaryCallToAction.oneOf.0.label","typeLabel":"string"},"url":{"description":"Where the button links, starting https:// or http://","example":"https://docs.tella.com/help","type":"string","isRequired":true,"uniqueKey":"details.video.settings.workspaceSecondaryCallToAction.oneOf.0.url","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.workspaceSecondaryCallToAction.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.video.settings.workspaceSecondaryCallToAction.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.workspaceSecondaryCallToAction","typeLabel":"object | null"},"zoomAnimationStyle":{"description":"How zooms ease in, out, and between each other, gentlest to snappiest. Zooms follow `layoutAnimationStyle` until one is set. `custom` is a spring set outside the named styles.","enum":["gentlest","gentle","relaxed","smooth","moderate","brisk","focused","snappy","punchy","snappiest","custom"],"example":"moderate","type":"string","isRequired":true,"uniqueKey":"details.video.settings.zoomAnimationStyle","typeLabel":"enum\u003cstring>"},"eyeContact":{"type":"object","description":"Eye contact correction: AI redirects the speaker's gaze to the camera lens in every camera recording. Only returned to callers who can edit the video, on the video itself (not the timeline).","required":["enabled","status","cameras","camerasReady"],"properties":{"cameras":{"description":"Camera recordings in the video. Screen recordings and uploaded videos are never changed.","example":1,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.video.settings.eyeContact.cameras","typeLabel":"integer"},"camerasReady":{"description":"Camera recordings that have their corrected version","example":1,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.video.settings.eyeContact.camerasReady","typeLabel":"integer"},"enabled":{"description":"Whether eye contact correction is on for the video","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.eyeContact.enabled","typeLabel":"boolean"},"status":{"description":"`processing` while the last switch is being applied (cameras are being prepared, or it is turning off); `ready` once every camera has its corrected version; `failed` when it is on but some cameras couldn't be prepared (those keep their original look); `off` when it is off.","enum":["off","processing","ready","failed"],"example":"ready","type":"string","isRequired":true,"uniqueKey":"details.video.settings.eyeContact.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.video.settings.eyeContact","typeLabel":"object"},"keystrokes":{"type":"object","description":"The keystroke HUD, once someone has configured it on the video.","required":["enabled","filter","style","size","displayDurationMs","animation","colors","position","alignment"],"properties":{"alignment":{"description":"Which horizontal edge of the HUD sits on position.x.","enum":["left","center","right"],"example":"center","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.alignment","typeLabel":"enum\u003cstring>"},"animation":{"type":"object","description":"How each chord enters and leaves. The text sides are always null.","required":["intro","outro","textIntro","textOutro","motionBlur"],"properties":{"intro":{"oneOf":[{"type":"object","description":"How the whole overlay enters, or null when it appears instantly.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.intro","typeLabel":"object | null"},"motionBlur":{"description":"Blur the overlay along its motion while it moves, scales or turns.","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.motionBlur","typeLabel":"boolean"},"outro":{"oneOf":[{"type":"object","description":"How the whole overlay leaves, or null when it disappears instantly.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.outro","typeLabel":"object | null"},"textIntro":{"oneOf":[{"type":"object","description":"How a text overlay's letters, words or lines enter, one after another, while `intro` plays on the whole box. Null when they don't.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textIntro","typeLabel":"object | null"},"textOutro":{"oneOf":[{"type":"object","description":"How a text overlay's letters, words or lines leave, one after another, while `outro` plays on the whole box. Null when they don't.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation.textOutro","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"details.video.settings.keystrokes.animation","typeLabel":"object"},"colors":{"additionalProperties":false,"description":"Colors in #RRGGBB or #RRGGBBAA form.","properties":{"background":{"description":"The container behind the keys.","example":"#FFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.colors.background","typeLabel":"string"},"keyBackground":{"description":"Each key's cap (or the pill).","example":"#FFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.colors.keyBackground","typeLabel":"string"},"keyText":{"description":"The key labels.","example":"#FFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.colors.keyText","typeLabel":"string"}},"required":["background","keyBackground","keyText"],"type":"object","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.colors","typeLabel":"object"},"displayDurationMs":{"description":"How long a chord lingers after its key is released, in milliseconds.","example":1000,"maximum":10000,"minimum":300,"type":"integer","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.displayDurationMs","typeLabel":"integer"},"enabled":{"description":"Show the HUD.","example":true,"type":"boolean","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.enabled","typeLabel":"boolean"},"filter":{"description":"`shortcuts` shows only chords with a modifier, such as ⌘C or ⇧Tab, and hides typing, capitals and shifted symbols included; `all` also shows plain typing, including any text typed while recording.","enum":["shortcuts","all"],"example":"shortcuts","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.filter","typeLabel":"enum\u003cstring>"},"position":{"additionalProperties":false,"description":"Anchor of the HUD as a fraction of the frame. `alignment` says which horizontal edge of the HUD sits on x.","properties":{"x":{"description":"0 is the left edge.","maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.position.x","typeLabel":"number"},"y":{"description":"0 is the top edge.","maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.position.y","typeLabel":"number"}},"required":["x","y"],"type":"object","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.position","typeLabel":"object"},"size":{"description":"Size multiplier from 0.5 to 4 (1 is a 44 px cap on a 1080p frame).","example":1,"maximum":4,"minimum":0.5,"type":"number","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.size","typeLabel":"number"},"style":{"description":"`keycap` draws one rounded cap per key in a container; `pill` draws the chord as text in one box.","enum":["keycap","pill"],"example":"keycap","type":"string","isRequired":true,"uniqueKey":"details.video.settings.keystrokes.style","typeLabel":"enum\u003cstring>"},"labels":{"description":"The keyboard the keys are labelled for. Absent, each recording's own keyboard: ⌘ for the Mac app, Ctrl for Auto Capture takes. `both` shows a shortcut with Mac and Windows keys (⌘ C / Ctrl C).","enum":["mac","windows","both"],"type":"string","uniqueKey":"details.video.settings.keystrokes.labels","typeLabel":"enum\u003cstring>"},"typing":{"description":"How `filter: all` shows plain typing. `keys` (the default when absent) shows one key per press; `words` grows a run of typing as text in one chip (backspace trims it; a pause, Return or a shortcut ends it), while shortcuts and keys pressed on their own still show as keys.","enum":["keys","words"],"example":"words","type":"string","uniqueKey":"details.video.settings.keystrokes.typing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"details.video.settings.keystrokes","typeLabel":"object"},"motionBlurAmount":{"description":"Motion blur strength, 0.1 (subtle) to 2 (strong); 1 is the default. Absent while motion blur is off.","example":1,"type":"number","uniqueKey":"details.video.settings.motionBlurAmount","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"details.video.settings","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"details.video","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"details","typeLabel":"object"}},"required":["video","clips","included"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"clips":[{"contents":{"blurs":4503599627370495,"cuts":4503599627370495,"highlights":4503599627370495,"layouts":4503599627370495,"overlays":4503599627370495,"soundEffects":4503599627370495,"textOverlays":4503599627370495,"transcriptWords":4503599627370495,"zooms":4503599627370495},"durationMs":1,"id":"\u003cstring>","name":"\u003cstring>","order":0,"timelineStartMs":1}],"included":["settings"],"video":{"aspectRatio":"16:9","description":"\u003cstring>","dimensions":{"height":123,"width":123},"durationMs":1,"id":"\u003cstring>","name":"\u003cstring>","updatedAt":"\u003cstring>"},"details":{"clips":[{"clipId":"\u003cstring>","background":{"type":"solid","color":"#000000ff","gradientAngle":45,"gradientColor1":"#ff0080ff","gradientColor2":"#7928caff","imageUrl":"\u003cstring>","shaderGradientPreset":"Halo","sourceId":"su_abc123","videoDurationSeconds":12.4,"videoUrl":"\u003cstring>"},"blurs":[{"dimensions":{"heightPct":50,"widthPct":50},"durationMs":2000,"id":"ly_abc123","intensity":0.7,"point":{"xPct":25,"yPct":25},"startTimeMs":1000,"transition":"smooth","type":"blur","cornerRadius":24,"corners":"regular"}],"cuts":[{"durationMs":750,"startTimeMs":1500}],"highlights":[{"dimensions":{"heightPct":50,"widthPct":50},"durationMs":2000,"id":"ly_abc123","intensity":0.7,"point":{"xPct":25,"yPct":25},"startTimeMs":1000,"transition":"smooth","type":"blur","cornerRadius":24,"corners":"regular"}],"layoutSceneType":"combi","layouts":[{"id":"\u003cstring>","media":[{"type":"image","documentId":"\u003cstring>","height":0,"imageUrl":"\u003cstring>","muted":true,"slot":"screen","sourceId":"\u003cstring>","startTimeMs":123,"width":0}],"cameraStyle":"none","crop":{"bottom":1,"left":1,"right":1,"top":1},"durationMs":5000,"followsBase":true,"layout":{"kind":"fullscreen","screenFit":"cover","style":"regular"},"popOut":{"amount":0.25,"background":"original","color":"\u003cstring>","outlineColor":"\u003cstring>","outlineWidth":0.025},"startTimeMs":0,"transitionStyle":"spring"}],"microphoneVolume":1,"overlays":[{"animation":{"intro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}},"motionBlur":true,"outro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}},"textIntro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}},"textOutro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}}},"depth":"behind_presenter","dimensions":{"height":540,"width":960},"durationMs":5000,"id":"ly_abc123","point":{"xPct":30,"yPct":30},"startTimeMs":1000,"transition":"hard_cut","type":"image","zIndex":0,"depthChanges":[{"atMs":1200,"depth":"behind_presenter"}],"imageUrl":"\u003cstring>","motionDocumentId":"ffd_abc123","name":"Logo","sourceId":"su_abc123"}],"soundEffects":[{"durationMs":3000,"id":"ly_abc123","startTimeMs":1000,"volume":1,"name":"Whoosh","sourceId":"su_abc123"}],"studioSound":true,"systemAudioVolume":1,"textOverlays":[{"animation":{"intro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}},"motionBlur":true,"outro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}},"textIntro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}},"textOutro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}}},"background":{"color":"#5E51F8FF","type":"solid"},"backgroundPadding":0.25,"backgroundShape":"squircle","color":"#FFFFFFFF","cornerRadius":24,"depth":"behind_presenter","dimensions":{"height":540,"width":960},"durationMs":5000,"fontFamily":"Inter","fontSize":81,"fontWeight":500,"fontWidth":100,"id":"ly_abc123","letterSpacing":-0.02,"lineHeight":1.5,"outline":"#000000FF","point":{"xPct":30,"yPct":30},"shadow":"subtle","startTimeMs":1000,"text":"Welcome back","textAlign":"center","transition":"hard_cut","zIndex":0,"depthChanges":[{"atMs":1200,"depth":"behind_presenter"}],"fontId":"media_abc123def456"}],"transcript":{"text":"\u003cstring>","wordCount":4503599627370495},"words":[{"breakAfter":false,"endTimeMs":1800,"hidden":false,"index":12,"keepWithNext":false,"startTimeMs":1500,"text":"Hello"}],"zooms":[{"durationMs":2000,"id":"ef_abc123","introTransition":"hard_cut","outroTransition":"smooth","startTimeMs":1000,"type":"manualZoom","focusPoint":{"xPct":50,"yPct":50},"scale":2}]}],"video":{"backgroundMusic":{"durationMs":180036,"name":"Calm Product Tour","url":"https://ucarecdn.com/example-track/","volume":0.2},"chapters":[{"description":"Overview of what we'll cover","timestampSeconds":0,"title":"Introduction"}],"settings":{"allowedEmbedDomains":["example.com","mysite.org"],"callToAction":{"label":"\u003cstring>","url":"https://docs.tella.com/help"},"callToActionsHidden":true,"captionFontFamily":"Inter","captionFontSize":64,"captionFontWeight":500,"captionGrouping":"chunked","captionLinesPerBlock":1,"captionPosition":{"x":0.5,"y":0.5},"captionSize":"medium","captionStyle":{"backgroundColor":"#5E51F8FF","name":"backdrop","textColor":"#5E51F8FF","wordLevelHighlights":true,"activeWordTextColor":"#5E51F8FF","backgroundBorderColor":"#5E51F8FF","backgroundBorderEnabled":true,"backgroundBorderWidth":0.25,"backgroundEnabled":true,"backgroundPadding":0.5,"backgroundRadius":1,"highlightColor":"#5E51F8FF","highlightMode":"text","maxWidth":0.65,"outlineColor":"#5E51F8FF","outlineEnabled":true,"outlineWidth":0.25,"shadowColor":"#5E51F8FF","shadowEnabled":true,"textCase":"original"},"captionsDefaultEnabled":true,"commentEmailsEnabled":false,"commentsEnabled":true,"creatorEnabled":true,"cursor":{"clickRipple":false,"hideWhenInactive":false,"returnToStart":false,"size":3.05,"smoothing":false,"style":"macTahoe","tilt":false,"tiltStrength":0.5},"customThumbnailURL":"https://example.com/custom-thumbnail.jpg","defaultClipTransition":"hard_cut","defaultPlaybackRate":1,"documentGenerationEnabled":true,"downloadsEnabled":true,"layoutAnimationStyle":"moderate","linkScope":"org","microphoneVolume":1,"motionBlur":true,"publishDateEnabled":true,"rawDownloadsEnabled":false,"searchEngineIndexingEnabled":true,"secondaryCallToAction":{"label":"\u003cstring>","url":"https://docs.tella.com/help"},"shrinkCameraDuringZooms":true,"studioSound":false,"studioSoundLevel":"off","subtitlesEnabled":true,"systemAudioVolume":1,"thumbnailInpointMs":12000,"transcriptsEnabled":true,"viewCountEnabled":true,"workspaceCallToAction":{"label":"\u003cstring>","url":"https://docs.tella.com/help"},"workspaceSecondaryCallToAction":{"label":"\u003cstring>","url":"https://docs.tella.com/help"},"zoomAnimationStyle":"moderate","eyeContact":{"cameras":1,"camerasReady":1,"enabled":true,"status":"ready"},"keystrokes":{"alignment":"center","animation":{"intro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}},"motionBlur":true,"outro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}},"textIntro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}},"textOutro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}}},"colors":{"background":"#FFFFFF","keyBackground":"#FFFFFF","keyText":"#FFFFFF"},"displayDurationMs":1000,"enabled":true,"filter":"shortcuts","position":{"x":0.5,"y":0.5},"size":1,"style":"keycap","labels":"mac","typing":"words"},"motionBlurAmount":1}}}}}},"exampleType":"generated"}},"description":"The video's edit state","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"generated"},"020c7336-d205-43de-92be-73b73fce97dd":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"bad_request","message":"The request was malformed or contained invalid parameters."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"bad_request","message":"The request was malformed or contained invalid parameters."}}},"exampleType":"examples"}},"description":"The request was malformed or contained invalid parameters.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"9fc4c3fb-db85-4d9c-9ef0-f04bb9e81fef":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"unauthorized","message":"Authentication is required. Provide a valid API key."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"unauthorized","message":"Authentication is required. Provide a valid API key."}}},"exampleType":"examples"}},"description":"Authentication is required. Provide a valid API key.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"9dcdc045-779a-44a9-b903-a92623132708":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"forbidden","message":"You don't have permission to access this resource."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"forbidden","message":"You don't have permission to access this resource."}}},"exampleType":"examples"}},"description":"You don't have permission to access this resource.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"69f506b6-c82d-40a8-9bfd-460a8bb31a22":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"not_found","message":"The requested resource was not found."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"not_found","message":"The requested resource was not found."}}},"exampleType":"examples"}},"description":"The requested resource was not found.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"0a1138ad-8e37-4151-ac8e-563a932ecf0c":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"conflict","message":"The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"conflict","message":"The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles."}}},"exampleType":"examples"}},"description":"The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"76dd6de1-c203-4ded-a3a8-8958baf5e1cb":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"rate_limited","message":"You have exceeded the rate limit. Please slow down."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"rate_limited","message":"You have exceeded the rate limit. Please slow down."}}},"exampleType":"examples"}},"description":"You have exceeded the rate limit. Please slow down.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a rate-limited request","example":45,"schema":{"minimum":1,"type":"integer"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"7d77e640-ffe2-4a74-8352-c4604e818347":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"server_error","message":"An unexpected error occurred"},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"server_error","message":"An unexpected error occurred"}}},"exampleType":"examples"}},"description":"An unexpected error occurred","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"a2e176d6-bd73-4dc0-ae71-bf8af113e8ac":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"not_implemented","message":"The requested operation is not implemented."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"not_implemented","message":"The requested operation is not implemented."}}},"exampleType":"examples"}},"description":"The requested operation is not implemented.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"185b58a5-a625-4ac9-9a5e-263bdf78c188":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"unavailable","message":"A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"unavailable","message":"A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay."}}},"exampleType":"examples"}},"description":"A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"}},"security":{"f03f247d-f307-4f34-b215-b51e9e648392":{"BearerAuth":{"description":"API key obtained from your Tella account settings","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"d2aabac2-b2bc-4b47-a6f4-a26614a56f79":{"description":"Production","url":"https://api.tella.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"API key obtained from your Tella account settings","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key obtained from your Tella account settings","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"tella","siteName":"Tella","title":"Get a video's timeline - Tella","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{},"searchTabScopes":[{"tab":"Help Center"},{"tab":"Developers"},{"tab":"Changelog"}]},"originalFileLocation":"api-reference/videos/get-a-videos-timeline.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns a compact ordered timeline outline by default: video identity, version, dimensions and duration plus every clip\u0026#x27;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\u0026#x27;s playback timeline (cuts applied). Raw cuts retain the source-recording timing used by the clip endpoints.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tella\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a video\u0026#x27;s timeline - Tella\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a compact ordered timeline outline by default: video identity, version, dimensions and duration plus every clip\u0026#x27;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\u0026#x27;s playback timeline (cuts applied). Raw cuts retain the source-recording timing used by the clip endpoints.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tella\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.tella.com/docs/api-reference/videos/get-a-videos-timeline\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tella.mintlify.site/docs/_mintlify/api/og/v2?division=Videos\u0026amp;title=Get+a+video%27s+timeline\u0026amp;description=Returns+a+compact+ordered+timeline+outline+by+default%3A+video+identity%2C+version%2C+dimensions+and+duration+plus+every+clip%27s+video-timeline+start%2C+playback+duratio\u0026amp;theme=83fc5c73f5b3900df40eca67\u0026amp;signature=1e4a5508431c026734f62097816899dafe4f0db2adfba62f280a570451744ddf\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get a video\u0026#x27;s timeline - Tella\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a compact ordered timeline outline by default: video identity, version, dimensions and duration plus every clip\u0026#x27;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\u0026#x27;s playback timeline (cuts applied). Raw cuts retain the source-recording timing used by the clip endpoints.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tella.mintlify.site/docs/_mintlify/api/og/v2?division=Videos\u0026amp;title=Get+a+video%27s+timeline\u0026amp;description=Returns+a+compact+ordered+timeline+outline+by+default%3A+video+identity%2C+version%2C+dimensions+and+duration+plus+every+clip%27s+video-timeline+start%2C+playback+duratio\u0026amp;theme=83fc5c73f5b3900df40eca67\u0026amp;signature=1e4a5508431c026734f62097816899dafe4f0db2adfba62f280a570451744ddf\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tella\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8278FA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.tella.com/docs/api-reference/videos/get-a-videos-timeline\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/videos/get-a-videos-timeline.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.tella.com/#organization\",\"name\":\"Tella\",\"url\":\"https://www.tella.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tella/znRZoQ3e3rlGBTT2/logo-light.svg?fit=max\u0026auto=format\u0026n=znRZoQ3e3rlGBTT2\u0026q=85\u0026s=dd044b03efe593b53353a039bfb31fbf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.tella.com/docs#website\",\"name\":\"Tella\",\"url\":\"https://www.tella.com/docs\",\"publisher\":{\"@id\":\"https://www.tella.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.tella.com/docs/api-reference/videos/get-a-videos-timeline#webpage\",\"url\":\"https://www.tella.com/docs/api-reference/videos/get-a-videos-timeline\",\"name\":\"Get a video's timeline\",\"description\":\"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.\",\"isPartOf\":{\"@id\":\"https://www.tella.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.tella.com/docs/api-reference/videos/get-a-videos-timeline#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.tella.com/docs/api-reference/videos/get-a-videos-timeline#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://www.tella.com/docs/api-reference/account/get-the-account\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Videos\",\"item\":\"https://www.tella.com/docs/api-reference/videos/list-connected-social-accounts\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get a video's timeline\",\"item\":\"https://www.tella.com/docs/api-reference/videos/get-a-videos-timeline\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.tella.com/docs/api-reference/videos/get-a-videos-timeline#apireference\",\"headline\":\"Get a video's timeline\",\"name\":\"Get a video's timeline\",\"description\":\"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.\",\"url\":\"https://www.tella.com/docs/api-reference/videos/get-a-videos-timeline\",\"mainEntityOfPage\":{\"@id\":\"https://www.tella.com/docs/api-reference/videos/get-a-videos-timeline#webpage\"},\"publisher\":{\"@id\":\"https://www.tella.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.tella.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tella\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tella\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/videos/get-a-videos-timeline.md","siteName":"Tella","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock-rotate-left","href":"/changelog"},{"anchor":"Community","icon":"users","href":"https://community.tella.tv"},{"anchor":"System Status","icon":"signal","href":"https://status.tella.com"},{"anchor":"Contact Support","icon":"envelope","href":"mailto:support@tella.com"},{"anchor":"Debug","icon":"bug","href":"/help/support/debug-camera-and-microphone-issues"}]},"tabs":[{"tab":"Help Center","pages":[{"title":"Help Center","href":"/help/introduction/welcome"}]},{"tab":"Developers","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Set up the Tella MCP server for your AI agent","sidebarTitle":"AI agent setup","href":"/ai-onboarding"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","href":"/authentication"},{"title":"Rate limiting","href":"/rate-limiting"},{"title":"API versioning and deprecation","href":"/versioning"}]},{"group":"Guides","pages":[{"title":"Webhooks","href":"/webhooks"},{"title":"Model Context Protocol (MCP)","href":"/mcp-server"},{"title":"Media library API","href":"/media-library-api"},{"title":"Embed API","href":"/embed-api"}]},{"group":"MCP Tools","pages":[{"group":"Managing videos","pages":[{"title":"Videos","href":"/mcp-tools/videos"},{"title":"Playlists","href":"/mcp-tools/playlists"},{"title":"Tags","href":"/mcp-tools/tags"},{"title":"Agent chats","href":"/mcp-tools/agent-chats"},{"title":"Community skills","href":"/mcp-tools/community-skills"},{"title":"Webhooks","href":"/mcp-tools/webhooks"},{"title":"Social publishing","href":"/mcp-tools/social-publishing"},{"title":"Analytics","href":"/mcp-tools/analytics"},{"title":"Account","href":"/mcp-tools/account"},{"title":"Billing","href":"/mcp-tools/billing"},{"title":"Support","href":"/mcp-tools/support"}]},{"group":"Editing videos","pages":[{"title":"Batch edits","href":"/mcp-tools/batch-edits"},{"title":"Sources","href":"/mcp-tools/sources"},{"title":"Library","href":"/mcp-tools/library"},{"title":"AI media generation","href":"/mcp-tools/ai-media-generation"},{"title":"Auto Capture","href":"/mcp-tools/auto-capture"},{"title":"Backgrounds","href":"/mcp-tools/backgrounds"},{"title":"Chapters","href":"/mcp-tools/chapters"},{"title":"Clips","href":"/mcp-tools/clips"},{"title":"Layouts","href":"/mcp-tools/layouts"},{"title":"Cropping","href":"/mcp-tools/cropping"},{"title":"Background Music","href":"/mcp-tools/background-music"},{"title":"Zooms","href":"/mcp-tools/zooms"},{"title":"Mouse events","href":"/mcp-tools/mouse-events"},{"title":"Key events","href":"/mcp-tools/key-events"},{"title":"Camera faces","href":"/mcp-tools/camera-faces"},{"title":"Blurs and highlights","href":"/mcp-tools/blurs-and-highlights"},{"title":"Overlays","href":"/mcp-tools/overlays"},{"title":"Text overlays","href":"/mcp-tools/text-overlays"},{"title":"Shape overlays","href":"/mcp-tools/shape-overlays"},{"title":"Sound effects","href":"/mcp-tools/sound-effects"}]},{"group":"Tella Motion","pages":[{"title":"Tella Motion","href":"/mcp-tools/motion"},{"title":"Tella Motion commands","href":"/mcp-tools/motion-commands"},{"title":"Tella Motion properties, easing and fonts","href":"/mcp-tools/motion-values"},{"title":"Tella Motion effects","href":"/mcp-tools/motion-effects"}]}]},{"group":"API Reference","pages":[{"group":"Account","pages":[{"title":"Get the account","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/account","href":"/api-reference/account/get-the-account"}]},{"group":"Agent chats","pages":[{"title":"List a video's agent chats","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/agent-chats","href":"/api-reference/agent-chats/list-a-videos-agent-chats"},{"title":"Start an agent chat","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/agent-chats","href":"/api-reference/agent-chats/start-an-agent-chat"}]},{"group":"Analytics","pages":[{"title":"Get workspace analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/analytics","href":"/api-reference/analytics/get-workspace-analytics"},{"title":"List workspace views","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/analytics/views","href":"/api-reference/analytics/list-workspace-views"},{"title":"List a playlist's views","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlists/{id}/views","href":"/api-reference/analytics/list-a-playlists-views"},{"title":"Get video analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/analytics","href":"/api-reference/analytics/get-video-analytics"},{"title":"List a video's views","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/views","href":"/api-reference/analytics/list-a-videos-views"}]},{"group":"Auto Capture","pages":[{"title":"Report an Auto Capture take","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auto-captures/{sourceId}/reports","href":"/api-reference/auto-capture/report-an-auto-capture-take"}]},{"group":"Backgrounds","pages":[{"title":"List available backgrounds","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/backgrounds","href":"/api-reference/backgrounds/list-available-backgrounds"}]},{"group":"Library","pages":[{"title":"List library items","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/library","href":"/api-reference/library/list-library-items"},{"title":"Add a source to the library","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library","href":"/api-reference/library/add-a-source-to-the-library"},{"title":"Split an image into layers","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library/decompositions","href":"/api-reference/library/split-an-image-into-layers"},{"title":"Generate media with AI","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library/generations","href":"/api-reference/library/generate-media-with-ai"},{"title":"Get a generation's status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/library/generations/{id}","href":"/api-reference/library/get-a-generations-status"},{"title":"Import media from a URL","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library/imports","href":"/api-reference/library/import-media-from-a-url"},{"title":"Get an import's status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/library/imports/{id}","href":"/api-reference/library/get-an-imports-status"},{"title":"Capture a web page or social post","deprecated":true,"version":null,"openapi":"/openapi.json post /v1/library/screenshots","href":"/api-reference/library/capture-a-web-page-or-social-post"},{"title":"Remove a library item","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/library/{id}","href":"/api-reference/library/remove-a-library-item"}]},{"group":"Tella Motion","pages":[{"title":"Add a Tella Motion clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/clips","href":"/api-reference/tella-motion/add-a-tella-motion-clip"},{"title":"List Tella Motion documents","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents","href":"/api-reference/tella-motion/list-tella-motion-documents"},{"title":"Create a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/documents","href":"/api-reference/tella-motion/create-a-tella-motion-document"},{"title":"Summarize a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}","href":"/api-reference/tella-motion/summarize-a-tella-motion-document"},{"title":"Edit a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/documents/{id}/commands","href":"/api-reference/tella-motion/edit-a-tella-motion-document"},{"title":"Inspect a composition","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/compositions/{compositionId}","href":"/api-reference/tella-motion/inspect-a-composition"},{"title":"Download a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/download","href":"/api-reference/tella-motion/download-a-tella-motion-document"},{"title":"Duplicate a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/documents/{id}/duplicate","href":"/api-reference/tella-motion/duplicate-a-tella-motion-document"},{"title":"List a document's media","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/media","href":"/api-reference/tella-motion/list-a-documents-media"},{"title":"Inspect a node's properties","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/nodes","href":"/api-reference/tella-motion/inspect-a-nodes-properties"},{"title":"Get a node's stored fields","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/nodes/raw","href":"/api-reference/tella-motion/get-a-nodes-stored-fields"},{"title":"Get a frame or preview of a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/thumbnail","href":"/api-reference/tella-motion/get-a-frame-or-preview-of-a-tella-motion-document"},{"title":"List Tella Motion effects","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/effects","href":"/api-reference/tella-motion/list-tella-motion-effects"},{"title":"List Tella Motion fonts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/fonts","href":"/api-reference/tella-motion/list-tella-motion-fonts"},{"title":"Get a Tella Motion JSON schema","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/schema","href":"/api-reference/tella-motion/get-a-tella-motion-json-schema"}]},{"group":"Playlist Groups","pages":[{"title":"List playlist groups","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlist-groups","href":"/api-reference/playlist-groups/list-playlist-groups"},{"title":"Create a playlist group","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/playlist-groups","href":"/api-reference/playlist-groups/create-a-playlist-group"},{"title":"Delete a playlist group","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/playlist-groups/{id}","href":"/api-reference/playlist-groups/delete-a-playlist-group"},{"title":"Rename or reorder a playlist group","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/playlist-groups/{id}","href":"/api-reference/playlist-groups/rename-or-reorder-a-playlist-group"}]},{"group":"Playlists","pages":[{"title":"List all playlists","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlists","href":"/api-reference/playlists/list-all-playlists"},{"title":"Create a new playlist","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/playlists","href":"/api-reference/playlists/create-a-new-playlist"},{"title":"Get playlist details","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlists/{id}","href":"/api-reference/playlists/get-playlist-details"},{"title":"Delete a playlist","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/playlists/{id}","href":"/api-reference/playlists/delete-a-playlist"},{"title":"Update a playlist","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/playlists/{id}","href":"/api-reference/playlists/update-a-playlist"},{"title":"Add a video to a playlist","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/playlists/{id}/videos","href":"/api-reference/playlists/add-a-video-to-a-playlist"},{"title":"Remove a video from a playlist","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/playlists/{id}/videos/{videoId}","href":"/api-reference/playlists/remove-a-video-from-a-playlist"}]},{"group":"Videos","pages":[{"title":"List connected social accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/social-accounts","href":"/api-reference/videos/list-connected-social-accounts"},{"title":"List subtitle presets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/subtitle-presets","href":"/api-reference/videos/list-subtitle-presets"},{"title":"Save a subtitle preset","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subtitle-presets","href":"/api-reference/videos/save-a-subtitle-preset"},{"title":"List all videos","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos","href":"/api-reference/videos/list-all-videos"},{"title":"Create a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos","href":"/api-reference/videos/create-a-video"},{"title":"Search videos","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/search","href":"/api-reference/videos/search-videos"},{"title":"Get video information","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}","href":"/api-reference/videos/get-video-information"},{"title":"Delete a video","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}","href":"/api-reference/videos/delete-a-video"},{"title":"Update a video","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}","href":"/api-reference/videos/update-a-video"},{"title":"Set background music","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/background-music","href":"/api-reference/videos/set-background-music"},{"title":"Remove background music","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/background-music","href":"/api-reference/videos/remove-background-music"},{"title":"Get the beats of the background music","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/background-music/beats","href":"/api-reference/videos/get-the-beats-of-the-background-music"},{"title":"Download video captions","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/captions","href":"/api-reference/videos/download-video-captions"},{"title":"Get video chapters","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/chapters","href":"/api-reference/videos/get-video-chapters"},{"title":"Replace video chapters","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/chapters","href":"/api-reference/videos/replace-video-chapters"},{"title":"Add a collaborator to a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/collaborators","href":"/api-reference/videos/add-a-collaborator-to-a-video"},{"title":"Generate a document from a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/documents","href":"/api-reference/videos/generate-a-document-from-a-video"},{"title":"Get a generated document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/documents/{documentId}","href":"/api-reference/videos/get-a-generated-document"},{"title":"Duplicate a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/duplicate","href":"/api-reference/videos/duplicate-a-video"},{"title":"Apply many video edits","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/edits","href":"/api-reference/videos/apply-many-video-edits"},{"title":"List video exports","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/exports","href":"/api-reference/videos/list-video-exports"},{"title":"Start a video export","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/exports","href":"/api-reference/videos/start-a-video-export"},{"title":"Get video export status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/exports/{exportId}","href":"/api-reference/videos/get-video-export-status"},{"title":"Get a live preview link","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/live-preview","href":"/api-reference/videos/get-a-live-preview-link"},{"title":"List social publications","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/publish","href":"/api-reference/videos/list-social-publications"},{"title":"Publish a video to social media","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/publish","href":"/api-reference/videos/publish-a-video-to-social-media"},{"title":"Cancel a scheduled publish","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/publish","href":"/api-reference/videos/cancel-a-scheduled-publish"},{"title":"Get a recording link","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/recording-link","href":"/api-reference/videos/get-a-recording-link"},{"title":"Get a video storyboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/storyboard","href":"/api-reference/videos/get-a-video-storyboard"},{"title":"Apply a subtitle preset","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/subtitle-preset","href":"/api-reference/videos/apply-a-subtitle-preset"},{"title":"Get a video thumbnail or animated preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/thumbnail","href":"/api-reference/videos/get-a-video-thumbnail-or-animated-preview"},{"title":"Set a video's thumbnail","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/thumbnail","href":"/api-reference/videos/set-a-videos-thumbnail"},{"title":"Remove a video's custom thumbnail","description":"Removes the custom thumbnail (uploaded image or picked frame) and reverts the video to its default auto-generated thumbnail.","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/thumbnail","href":"/api-reference/videos/remove-a-videos-custom-thumbnail"},{"title":"Get a video's timeline","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/timeline","href":"/api-reference/videos/get-a-videos-timeline"}]},{"group":"Sources","pages":[{"title":"Create a source upload (video, audio, image, or LUT)","description":"Returns a `sourceId` and a pre-signed S3 URL. PUT the file bytes to `uploadUrl`, then reference `sourceId` from clips, layouts (b-roll media), overlays, or backgrounds. For a 3D .cube LUT use `kind: \"lut\"`, omit dimensions and duration, upload unchanged, then save it with `POST /v1/library` and apply the returned item id with `PATCH /v1/videos/{id}/clips/{clipId}/filters`. Use `kind: \"image\"` for images (no `duration`); Tella hosts the bytes for rendering, so you never deal with raw image URLs. To reuse an uploaded source in other videos, save it to the workspace library with `POST /v1/library` (`scope: \"workspace\"`); `GET /v1/library` then finds it from any video.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sources","href":"/api-reference/sources/create-a-source-upload-video-audio-image-or-lut"},{"title":"Get a source's processing status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}","href":"/api-reference/sources/get-a-sources-processing-status"},{"title":"Get the beats of an audio or video source","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/beats","href":"/api-reference/sources/get-the-beats-of-an-audio-or-video-source"},{"title":"Get a streaming upload storyboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/storyboard","href":"/api-reference/sources/get-a-streaming-upload-storyboard"},{"title":"Get a thumbnail of a source on no clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/thumbnail","href":"/api-reference/sources/get-a-thumbnail-of-a-source-on-no-clip"},{"title":"Get the transcript of a source on no clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/transcript","href":"/api-reference/sources/get-the-transcript-of-a-source-on-no-clip"},{"title":"Get the audio waveform JSON for a source on no clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/waveform","href":"/api-reference/sources/get-the-audio-waveform-json-for-a-source-on-no-clip"}]},{"group":"Tags","pages":[{"title":"List all tags","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/tags","href":"/api-reference/tags/list-all-tags"},{"title":"Create a new tag","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/tags","href":"/api-reference/tags/create-a-new-tag"},{"title":"Delete a tag","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/tags/{id}","href":"/api-reference/tags/delete-a-tag"},{"title":"Update a tag","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/tags/{id}","href":"/api-reference/tags/update-a-tag"},{"title":"List a video's tags","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/tags","href":"/api-reference/tags/list-a-videos-tags"},{"title":"Add a tag to a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/tags","href":"/api-reference/tags/add-a-tag-to-a-video"},{"title":"Remove a tag from a video","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/tags/{tagId}","href":"/api-reference/tags/remove-a-tag-from-a-video"}]},{"group":"Clips","pages":[{"title":"List text presets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/text-presets","href":"/api-reference/clips/list-text-presets"},{"title":"Save a text preset","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/text-presets","href":"/api-reference/clips/save-a-text-preset"},{"title":"Delete a text preset","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/text-presets/{presetId}","href":"/api-reference/clips/delete-a-text-preset"},{"title":"List clips for a video","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips","href":"/api-reference/clips/list-clips-for-a-video"},{"title":"Add a clip from an uploaded source","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips","href":"/api-reference/clips/add-a-clip-from-an-uploaded-source"},{"title":"Get a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}","href":"/api-reference/clips/get-a-clip"},{"title":"Delete a clip","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}","href":"/api-reference/clips/delete-a-clip"},{"title":"Update a clip","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}","href":"/api-reference/clips/update-a-clip"},{"title":"Get audio levels in a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/audio-levels","href":"/api-reference/clips/get-audio-levels-in-a-clip"},{"title":"Auto-crop a clip's screen recording","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/auto-crop","href":"/api-reference/clips/auto-crop-a-clips-screen-recording"},{"title":"List blurs on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/blurs","href":"/api-reference/clips/list-blurs-on-a-clip"},{"title":"Add a blur to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/blurs","href":"/api-reference/clips/add-a-blur-to-a-clip"},{"title":"Remove a blur","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/blurs/{maskId}","href":"/api-reference/clips/remove-a-blur"},{"title":"Update a blur","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/blurs/{maskId}","href":"/api-reference/clips/update-a-blur"},{"title":"List faces in a clip's camera","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/camera-faces","href":"/api-reference/clips/list-faces-in-a-clips-camera"},{"title":"Cut one or more time ranges from a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/cut","href":"/api-reference/clips/cut-one-or-more-time-ranges-from-a-clip"},{"title":"Cut clip ranges by transcript word indices","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/cut-by-transcript","href":"/api-reference/clips/cut-clip-ranges-by-transcript-word-indices"},{"title":"Duplicate a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/duplicate","href":"/api-reference/clips/duplicate-a-clip"},{"title":"Get clip color filters","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/filters","href":"/api-reference/clips/get-clip-color-filters"},{"title":"Set clip color filters","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/filters","href":"/api-reference/clips/set-clip-color-filters"},{"title":"List highlights on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/highlights","href":"/api-reference/clips/list-highlights-on-a-clip"},{"title":"Add a highlight to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/highlights","href":"/api-reference/clips/add-a-highlight-to-a-clip"},{"title":"Remove a highlight","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/highlights/{maskId}","href":"/api-reference/clips/remove-a-highlight"},{"title":"Update a highlight","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/highlights/{maskId}","href":"/api-reference/clips/update-a-highlight"},{"title":"List key presses on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/key-events","href":"/api-reference/clips/list-key-presses-on-a-clip"},{"title":"List layouts on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/layouts","href":"/api-reference/clips/list-layouts-on-a-clip"},{"title":"Add a layout to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/layouts","href":"/api-reference/clips/add-a-layout-to-a-clip"},{"title":"Remove a layout","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/layouts/{layoutId}","href":"/api-reference/clips/remove-a-layout"},{"title":"Update a layout","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/layouts/{layoutId}","href":"/api-reference/clips/update-a-layout"},{"title":"List mouse events on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/mouse-events","href":"/api-reference/clips/list-mouse-events-on-a-clip"},{"title":"List overlays on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/overlays","href":"/api-reference/clips/list-overlays-on-a-clip"},{"title":"Add an overlay to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/overlays","href":"/api-reference/clips/add-an-overlay-to-a-clip"},{"title":"Remove an overlay","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/overlays/{overlayId}","href":"/api-reference/clips/remove-an-overlay"},{"title":"Update an overlay","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/overlays/{overlayId}","href":"/api-reference/clips/update-an-overlay"},{"title":"Remove filler words from a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/remove-fillers","href":"/api-reference/clips/remove-filler-words-from-a-clip"},{"title":"Remove silences from a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/remove-silences","href":"/api-reference/clips/remove-silences-from-a-clip"},{"title":"Reorder a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/reorder","href":"/api-reference/clips/reorder-a-clip"},{"title":"List shape overlays on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/shape-overlays","href":"/api-reference/clips/list-shape-overlays-on-a-clip"},{"title":"Add a shape overlay to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/shape-overlays","href":"/api-reference/clips/add-a-shape-overlay-to-a-clip"},{"title":"Remove a shape overlay","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/shape-overlays/{shapeOverlayId}","href":"/api-reference/clips/remove-a-shape-overlay"},{"title":"Update a shape overlay","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/shape-overlays/{shapeOverlayId}","href":"/api-reference/clips/update-a-shape-overlay"},{"title":"Get silent ranges in a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/silences","href":"/api-reference/clips/get-silent-ranges-in-a-clip"},{"title":"List sound effects on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sound-effects","href":"/api-reference/clips/list-sound-effects-on-a-clip"},{"title":"Add a sound effect to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/sound-effects","href":"/api-reference/clips/add-a-sound-effect-to-a-clip"},{"title":"Remove a sound effect","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/sound-effects/{soundEffectId}","href":"/api-reference/clips/remove-a-sound-effect"},{"title":"Update a sound effect","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/sound-effects/{soundEffectId}","href":"/api-reference/clips/update-a-sound-effect"},{"title":"List sources for a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sources","href":"/api-reference/clips/list-sources-for-a-clip"},{"title":"Get a source thumbnail or animated preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sources/{sourceId}/thumbnail","href":"/api-reference/clips/get-a-source-thumbnail-or-animated-preview"},{"title":"Get the audio waveform JSON for a source","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sources/{sourceId}/waveform","href":"/api-reference/clips/get-the-audio-waveform-json-for-a-source"},{"title":"Split a clip in two","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/split","href":"/api-reference/clips/split-a-clip-in-two"},{"title":"Get a clip storyboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/storyboard","href":"/api-reference/clips/get-a-clip-storyboard"},{"title":"List text overlays on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/text-overlays","href":"/api-reference/clips/list-text-overlays-on-a-clip"},{"title":"Add a text overlay to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/text-overlays","href":"/api-reference/clips/add-a-text-overlay-to-a-clip"},{"title":"Remove a text overlay","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/text-overlays/{textOverlayId}","href":"/api-reference/clips/remove-a-text-overlay"},{"title":"Update a text overlay","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/text-overlays/{textOverlayId}","href":"/api-reference/clips/update-a-text-overlay"},{"title":"Get a clip thumbnail or animated preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/thumbnail","href":"/api-reference/clips/get-a-clip-thumbnail-or-animated-preview"},{"title":"Get clip transcript","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/transcript","href":"/api-reference/clips/get-clip-transcript"},{"title":"Correct transcript words","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/transcript/words","href":"/api-reference/clips/correct-transcript-words"},{"title":"List zooms on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/zooms","href":"/api-reference/clips/list-zooms-on-a-clip"},{"title":"Add a zoom to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/zooms","href":"/api-reference/clips/add-a-zoom-to-a-clip"},{"title":"Auto-generate zooms from mouse activity","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/zooms/auto","href":"/api-reference/clips/auto-generate-zooms-from-mouse-activity"},{"title":"Remove a zoom","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/zooms/{zoomId}","href":"/api-reference/clips/remove-a-zoom"},{"title":"Update a zoom","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/zooms/{zoomId}","href":"/api-reference/clips/update-a-zoom"}]},{"group":"Webhooks","pages":[{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/endpoints","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/endpoints","href":"/api-reference/webhooks/create-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/webhooks/endpoints/{id}","href":"/api-reference/webhooks/delete-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/webhooks/endpoints/{id}","href":"/api-reference/webhooks/update-a-webhook-endpoint"},{"title":"Get endpoint signing secret","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/endpoints/{id}/secret","href":"/api-reference/webhooks/get-endpoint-signing-secret"},{"title":"List recent webhook messages","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/messages","href":"/api-reference/webhooks/list-recent-webhook-messages"},{"title":"Get a specific webhook message","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/messages/{id}","href":"/api-reference/webhooks/get-a-specific-webhook-message"}]}]},{"group":"Webhooks","pages":[{"group":"Videos","pages":[{"title":"Document generated","version":null,"deprecated":null,"openapi":"/webhooks.json webhook document.generated","href":"/api-reference/videos/document-generated"},{"title":"Export ready","version":null,"deprecated":null,"openapi":"/webhooks.json webhook export.ready","href":"/api-reference/videos/export-ready"},{"title":"Transcript ready","version":null,"deprecated":null,"openapi":"/webhooks.json webhook transcript.ready","href":"/api-reference/videos/transcript-ready"},{"title":"Video created","version":null,"deprecated":null,"openapi":"/webhooks.json webhook video.created","href":"/api-reference/videos/video-created"},{"title":"View milestone reached","version":null,"deprecated":null,"openapi":"/webhooks.json webhook video.milestone","href":"/api-reference/videos/view-milestone-reached"},{"title":"Video viewed","version":null,"deprecated":null,"openapi":"/webhooks.json webhook video.viewed","href":"/api-reference/videos/video-viewed"}]},{"group":"Playlists","pages":[{"title":"Playlist created","version":null,"deprecated":null,"openapi":"/webhooks.json webhook playlist.created","href":"/api-reference/playlists/playlist-created"},{"title":"Video added to playlist","version":null,"deprecated":null,"openapi":"/webhooks.json webhook playlist.video_added","href":"/api-reference/playlists/video-added-to-playlist"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Get a video's timeline - Tella","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","CodeSnippet-CTZvgJfu.js","getApiPlaygroundDisplay-BK2o1XYu.js","Page--B9YZ09u.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js","Markdown-CH4mv0N8.js","AssistantPageLink-BHjmqccN.js","dist-DYCPzQwJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}