{
"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."
}
Add a text overlay to a clip
Adds a text overlay to a clip. Nothing needs uploading — pass the copy directly. Font, color, position and size all fall back to the editor’s defaults.
{
"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
Video identifier
Example:
"vid_abc123def456"
clipId
string
required
Clip identifier
Example:
"cl_xyz789ghi012"
Body
application/json
Add a text overlay to a clip. Nothing needs uploading — pass the copy directly. When point/dimensions are omitted, a centered box 60% of the artboard wide and 25% tall is used.
durationMs
integer
required
Required range: 0 < x <= 9007199254740991
Example:
5000
startTimeMs
integer
required
Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.
Required range: 0 <= x <= 9007199254740991
Example:
1000
text
string
required
Minimum string length: 1
Example:
"Welcome back"
animation
object
How the overlay enters and leaves; when set it replaces transition. Each side describes the hidden state the overlay moves from on the way in and back to on the way out. An omitted side stays as it is. {intro: {preset: 'slide_up'}, outro: {preset: 'fade'}} is a complete animation; on text, {textIntro: {preset: 'slide_up', text: {unit: 'words'}}} brings the words in one by one.
Hide child attributes
animation.intro
object | null
How the whole overlay enters, or null to appear instantly. Takes no text. Omit to keep the current intro.
Hide child attributes
animation.intro.blur
number
Blur of the hidden state in pixels.
Required range: 0 <= x <= 200
animation.intro.clip
boolean
Clip the motion to the overlay's box, so it wipes in like a mask.
animation.intro.durationMs
number
How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.
Required range: 50 <= x <= 5000
animation.intro.easing
object
How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.
Hide child attributes
animation.intro.easing.curve
enum<string>
required
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.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
bounce,
overshoot,
impulse,
swing,
custom,
spring
Example:
"slow_down"
animation.intro.easing.bezier
number[]
For custom: the handles. Defaults to the side's current curve.
Required array length: 4 elements
Required range: 0 <= x <= 1
Example:
[0.25, 0.1, 0.25, 1]
animation.intro.easing.intensity
number
How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.
Required range: 0 <= x <= 1
animation.intro.easing.spring
object
For spring: its physics. Defaults to stiffness 200, damping 12, mass 1.
Hide child attributes
animation.intro.easing.spring.damping
number
required
Required range: 1 <= x <= 300
Example:
12
animation.intro.easing.spring.mass
number
required
Required range: 0.1 <= x <= 10
Example:
1
animation.intro.easing.spring.stiffness
number
required
Required range: 1 <= x <= 1000
Example:
200
animation.intro.moveX
number
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.
Required range: -10 <= x <= 10
animation.intro.moveY
number
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.
Required range: -10 <= x <= 10
animation.intro.opacity
number
Opacity of the hidden state, 0 to 1.
Required range: 0 <= x <= 1
animation.intro.preset
enum<string>
Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from fade.
Available options:
fade,
slide_up,
slide_down,
slide_left,
slide_right,
mask_up,
mask_down,
grow,
shrink,
blur,
blur_slide_up
Example:
"slide_up"
animation.intro.rotate
number
Clockwise rotation of the hidden state in degrees.
Required range: -3600 <= x <= 3600
animation.intro.scale
number
Scale of the hidden state; 1 is its resting size.
Required range: 0 <= x <= 10
animation.intro.text
object
On textIntro/textOutro only: which units play the side, each in turn. Required on a new text side.
Hide child attributes
animation.intro.text.unit
enum<string>
required
What animates on its own.
Available options:
letters,
words,
lines
Example:
"words"
animation.intro.text.delayMs
number
How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.
Required range: 0 <= x <= 2000
animation.intro.text.order
enum<string>
Which unit goes first. random uses the same shuffle every time. Defaults to forward.
Available options:
forward,
backward,
center,
edges,
random
Example:
"forward"
animation.intro.text.smoothing
enum<string>
Eases the delays across the units. Defaults to linear.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
overshoot,
impulse,
swing
Example:
"linear"
animation.motionBlur
boolean
Blur the overlay along its motion while it moves, scales or turns. Defaults to true.
animation.outro
object | null
How the whole overlay leaves, or null to disappear instantly. Takes no text. Omit to keep the current outro.
Hide child attributes
animation.outro.blur
number
Blur of the hidden state in pixels.
Required range: 0 <= x <= 200
animation.outro.clip
boolean
Clip the motion to the overlay's box, so it wipes in like a mask.
animation.outro.durationMs
number
How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.
Required range: 50 <= x <= 5000
animation.outro.easing
object
How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.
Hide child attributes
animation.outro.easing.curve
enum<string>
required
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.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
bounce,
overshoot,
impulse,
swing,
custom,
spring
Example:
"slow_down"
animation.outro.easing.bezier
number[]
For custom: the handles. Defaults to the side's current curve.
Required array length: 4 elements
Required range: 0 <= x <= 1
Example:
[0.25, 0.1, 0.25, 1]
animation.outro.easing.intensity
number
How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.
Required range: 0 <= x <= 1
animation.outro.easing.spring
object
For spring: its physics. Defaults to stiffness 200, damping 12, mass 1.
Hide child attributes
animation.outro.easing.spring.damping
number
required
Required range: 1 <= x <= 300
Example:
12
animation.outro.easing.spring.mass
number
required
Required range: 0.1 <= x <= 10
Example:
1
animation.outro.easing.spring.stiffness
number
required
Required range: 1 <= x <= 1000
Example:
200
animation.outro.moveX
number
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.
Required range: -10 <= x <= 10
animation.outro.moveY
number
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.
Required range: -10 <= x <= 10
animation.outro.opacity
number
Opacity of the hidden state, 0 to 1.
Required range: 0 <= x <= 1
animation.outro.preset
enum<string>
Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from fade.
Available options:
fade,
slide_up,
slide_down,
slide_left,
slide_right,
mask_up,
mask_down,
grow,
shrink,
blur,
blur_slide_up
Example:
"slide_up"
animation.outro.rotate
number
Clockwise rotation of the hidden state in degrees.
Required range: -3600 <= x <= 3600
animation.outro.scale
number
Scale of the hidden state; 1 is its resting size.
Required range: 0 <= x <= 10
animation.outro.text
object
On textIntro/textOutro only: which units play the side, each in turn. Required on a new text side.
Hide child attributes
animation.outro.text.unit
enum<string>
required
What animates on its own.
Available options:
letters,
words,
lines
Example:
"words"
animation.outro.text.delayMs
number
How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.
Required range: 0 <= x <= 2000
animation.outro.text.order
enum<string>
Which unit goes first. random uses the same shuffle every time. Defaults to forward.
Available options:
forward,
backward,
center,
edges,
random
Example:
"forward"
animation.outro.text.smoothing
enum<string>
Eases the delays across the units. Defaults to linear.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
overshoot,
impulse,
swing
Example:
"linear"
animation.textIntro
object | null
Text overlays only: how its letters, words or lines enter, one after another, or null for none. Plays alongside intro: both start together.
Hide child attributes
animation.textIntro.blur
number
Blur of the hidden state in pixels.
Required range: 0 <= x <= 200
animation.textIntro.clip
boolean
Clip the motion to the overlay's box, so it wipes in like a mask.
animation.textIntro.durationMs
number
How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.
Required range: 50 <= x <= 5000
animation.textIntro.easing
object
How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.
Hide child attributes
animation.textIntro.easing.curve
enum<string>
required
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.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
bounce,
overshoot,
impulse,
swing,
custom,
spring
Example:
"slow_down"
animation.textIntro.easing.bezier
number[]
For custom: the handles. Defaults to the side's current curve.
Required array length: 4 elements
Required range: 0 <= x <= 1
Example:
[0.25, 0.1, 0.25, 1]
animation.textIntro.easing.intensity
number
How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.
Required range: 0 <= x <= 1
animation.textIntro.easing.spring
object
For spring: its physics. Defaults to stiffness 200, damping 12, mass 1.
Hide child attributes
animation.textIntro.easing.spring.damping
number
required
Required range: 1 <= x <= 300
Example:
12
animation.textIntro.easing.spring.mass
number
required
Required range: 0.1 <= x <= 10
Example:
1
animation.textIntro.easing.spring.stiffness
number
required
Required range: 1 <= x <= 1000
Example:
200
animation.textIntro.moveX
number
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.
Required range: -10 <= x <= 10
animation.textIntro.moveY
number
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.
Required range: -10 <= x <= 10
animation.textIntro.opacity
number
Opacity of the hidden state, 0 to 1.
Required range: 0 <= x <= 1
animation.textIntro.preset
enum<string>
Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from fade.
Available options:
fade,
slide_up,
slide_down,
slide_left,
slide_right,
mask_up,
mask_down,
grow,
shrink,
blur,
blur_slide_up
Example:
"slide_up"
animation.textIntro.rotate
number
Clockwise rotation of the hidden state in degrees.
Required range: -3600 <= x <= 3600
animation.textIntro.scale
number
Scale of the hidden state; 1 is its resting size.
Required range: 0 <= x <= 10
animation.textIntro.text
object
On textIntro/textOutro only: which units play the side, each in turn. Required on a new text side.
Hide child attributes
animation.textIntro.text.unit
enum<string>
required
What animates on its own.
Available options:
letters,
words,
lines
Example:
"words"
animation.textIntro.text.delayMs
number
How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.
Required range: 0 <= x <= 2000
animation.textIntro.text.order
enum<string>
Which unit goes first. random uses the same shuffle every time. Defaults to forward.
Available options:
forward,
backward,
center,
edges,
random
Example:
"forward"
animation.textIntro.text.smoothing
enum<string>
Eases the delays across the units. Defaults to linear.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
overshoot,
impulse,
swing
Example:
"linear"
animation.textOutro
object | null
Text overlays only: how its letters, words or lines leave, one after another, or null for none. Plays alongside outro: both end together.
Hide child attributes
animation.textOutro.blur
number
Blur of the hidden state in pixels.
Required range: 0 <= x <= 200
animation.textOutro.clip
boolean
Clip the motion to the overlay's box, so it wipes in like a mask.
animation.textOutro.durationMs
number
How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.
Required range: 50 <= x <= 5000
animation.textOutro.easing
object
How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.
Hide child attributes
animation.textOutro.easing.curve
enum<string>
required
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.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
bounce,
overshoot,
impulse,
swing,
custom,
spring
Example:
"slow_down"
animation.textOutro.easing.bezier
number[]
For custom: the handles. Defaults to the side's current curve.
Required array length: 4 elements
Required range: 0 <= x <= 1
Example:
[0.25, 0.1, 0.25, 1]
animation.textOutro.easing.intensity
number
How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.
Required range: 0 <= x <= 1
animation.textOutro.easing.spring
object
For spring: its physics. Defaults to stiffness 200, damping 12, mass 1.
Hide child attributes
animation.textOutro.easing.spring.damping
number
required
Required range: 1 <= x <= 300
Example:
12
animation.textOutro.easing.spring.mass
number
required
Required range: 0.1 <= x <= 10
Example:
1
animation.textOutro.easing.spring.stiffness
number
required
Required range: 1 <= x <= 1000
Example:
200
animation.textOutro.moveX
number
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.
Required range: -10 <= x <= 10
animation.textOutro.moveY
number
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.
Required range: -10 <= x <= 10
animation.textOutro.opacity
number
Opacity of the hidden state, 0 to 1.
Required range: 0 <= x <= 1
animation.textOutro.preset
enum<string>
Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from fade.
Available options:
fade,
slide_up,
slide_down,
slide_left,
slide_right,
mask_up,
mask_down,
grow,
shrink,
blur,
blur_slide_up
Example:
"slide_up"
animation.textOutro.rotate
number
Clockwise rotation of the hidden state in degrees.
Required range: -3600 <= x <= 3600
animation.textOutro.scale
number
Scale of the hidden state; 1 is its resting size.
Required range: 0 <= x <= 10
animation.textOutro.text
object
On textIntro/textOutro only: which units play the side, each in turn. Required on a new text side.
Hide child attributes
animation.textOutro.text.unit
enum<string>
required
What animates on its own.
Available options:
letters,
words,
lines
Example:
"words"
animation.textOutro.text.delayMs
number
How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.
Required range: 0 <= x <= 2000
animation.textOutro.text.order
enum<string>
Which unit goes first. random uses the same shuffle every time. Defaults to forward.
Available options:
forward,
backward,
center,
edges,
random
Example:
"forward"
animation.textOutro.text.smoothing
enum<string>
Eases the delays across the units. Defaults to linear.
Background behind the text. Defaults to transparent.
Hide child attributes
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"
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"
backgroundPadding
number
Defaults to 0, or the preset's.
Required range: 0 <= x <= 1
Example:
0.25
backgroundShape
enum<string>
Defaults to none.
Available options:
none,
regular,
squircle
Example:
"squircle"
color
string
Defaults to white.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#FFFFFFFF"
cornerRadius
number
Corner radius in story pixels, replacing the rounded shape's own (regular is 16 on a text background, squircle 32; on a square 12% and 24% of its shorter side). Needs a regular or squircle shape; setting the shape again without it goes back to the shape's own radius.
Required range: 0 <= x <= 512
Example:
24
depth
enum<string>
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"
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
depthChanges.atMs
number
required
Ms after the overlay starts.
Required range: x >= 0
Example:
1200
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"
dimensions
object
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
dimensions.height
number
required
Required range: x > 0
Example:
540
dimensions.width
number
required
Required range: x > 0
Example:
960
fontFamily
enum<string>
One of Tella's catalog font families. Defaults to Inter. Anything outside the catalog is rejected rather than silently falling back; use fontId for an uploaded font.
Available options:
Inter,
Roboto Mono,
Archivo,
Barlow,
Caveat,
DM Sans,
Figtree,
Lora,
Merriweather,
Montserrat,
Nunito Sans,
Open Sans,
Oswald,
Playfair Display,
Poppins,
Raleway,
Roboto,
Roboto Flex,
Source Sans 3,
Space Grotesk
Example:
"Inter"
fontId
string
A custom font from the private or workspace library: the id of a font item from GET /v1/library?type=font, such as one uploaded with POST /v1/sources (kind: font) and POST /v1/library. Sets the overlay's font family to that font. Don't combine with fontFamily.
Minimum string length: 1
Example:
"media_abc123def456"
fontSize
number
Font size in artboard pixels. Defaults to 7.5% of the video's shorter side, which is the editor's default and readable at any canvas size.
Required range: x > 0
Example:
81
fontWeight
number
Variable-font weight axis — 100 (thin) to 900 (black), 500 by default. Values outside the chosen font's own axis range are clamped when rendered.
Required range: 1 <= x <= 1000
Example:
500
fontWidth
number
Variable-font width axis, as a percentage — 100 is normal, 50 ultra-condensed, 150 extra-expanded, 100 by default. Values outside the chosen font's own axis range are clamped when rendered.
Required range: x > 0
Example:
100
letterSpacing
number
Defaults to 0, or the preset's.
Required range: -0.2 <= x <= 1
Example:
-0.02
lineHeight
number
Defaults to 1.2, or the preset's.
Required range: 0.8 <= x <= 3
Example:
1.5
outline
string | null
Defaults to no outline, or the preset's.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#000000FF"
point
object
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
point.xPct
number
required
Example:
30
point.yPct
number
required
Example:
30
presetId
string
A preset from GET /v1/text-presets — default:<id> for a built-in style or a saved preset's ID. Supplies the font, weight, width, color, size, alignment, tracking, background, background shape, background padding and outline (not the shadow); any of those fields sent alongside overrides the preset's value.
Minimum string length: 1
Example:
"default:label"
shadow
enum<string>
Defaults to none.
Available options:
none,
subtle,
deep
Example:
"subtle"
textAlign
enum<string>
Defaults to center.
Available options:
left,
center,
right
Example:
"center"
transition
enum<string>
Intro/outro animation: smooth fades the text in at its start and out at its end, hard_cut pops it in and out. An animation replaces it while set.
Available options:
smooth,
hard_cut
Example:
"smooth"
Response
OK
A text overlay on a clip
textOverlay
object
required
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.
Hide child attributes
textOverlay.animation
object | null
required
How the text enters and leaves, or null when it plays its transition.
Hide child attributes
textOverlay.animation.intro
object | null
required
How the whole overlay enters, or null when it appears instantly.
Hide child attributes
textOverlay.animation.intro.blur
number
required
Blur of the hidden state in pixels.
Example:
0
textOverlay.animation.intro.clip
boolean
required
Clip the motion to the overlay's box, so it wipes in like a mask.
Example:
false
textOverlay.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
Example:
500
textOverlay.animation.intro.easing
object
required
Hide child attributes
textOverlay.animation.intro.easing.curve
enum<string>
required
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.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
bounce,
overshoot,
impulse,
swing,
custom,
spring
Example:
"slow_down"
textOverlay.animation.intro.easing.intensity
number
required
How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.
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
textOverlay.animation.intro.moveY
number
required
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
textOverlay.animation.intro.opacity
number
required
Opacity of the hidden state, 0 to 1.
Example:
0
textOverlay.animation.intro.preset
enum<string> | null
required
The preset the side matches, or null once its motion is custom.
Available options:
fade,
slide_up,
slide_down,
slide_left,
slide_right,
mask_up,
mask_down,
grow,
shrink,
blur,
blur_slide_up
Example:
"slide_up"
textOverlay.animation.intro.rotate
number
required
Clockwise rotation of the hidden state in degrees.
Example:
0
textOverlay.animation.intro.scale
number
required
Scale of the hidden state; 1 is its resting size.
Example:
1
textOverlay.animation.intro.text
object
The units a text side plays on, each in turn.
Hide child attributes
textOverlay.animation.intro.text.delayMs
integer
required
How long after one unit the next starts, in ms (0 to 2000).
Required range: 0 <= x <= 2000
Example:
100
textOverlay.animation.intro.text.order
enum<string>
required
Which unit goes first. random uses the same shuffle every time.
Available options:
forward,
backward,
center,
edges,
random
Example:
"forward"
textOverlay.animation.intro.text.smoothing
enum<string>
required
Eases the delays across the units: linear is an even step, the other curves bunch the starts up at one end.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
overshoot,
impulse,
swing
Example:
"linear"
textOverlay.animation.intro.text.unit
enum<string>
required
What animates on its own.
Available options:
letters,
words,
lines
Example:
"words"
textOverlay.animation.motionBlur
boolean
required
Blur the overlay along its motion while it moves, scales or turns.
Example:
true
textOverlay.animation.outro
object | null
required
How the whole overlay leaves, or null when it disappears instantly.
Hide child attributes
textOverlay.animation.outro.blur
number
required
Blur of the hidden state in pixels.
Example:
0
textOverlay.animation.outro.clip
boolean
required
Clip the motion to the overlay's box, so it wipes in like a mask.
Example:
false
textOverlay.animation.outro.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
Example:
500
textOverlay.animation.outro.easing
object
required
Hide child attributes
textOverlay.animation.outro.easing.curve
enum<string>
required
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.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
bounce,
overshoot,
impulse,
swing,
custom,
spring
Example:
"slow_down"
textOverlay.animation.outro.easing.intensity
number
required
How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.
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
textOverlay.animation.outro.moveY
number
required
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
textOverlay.animation.outro.opacity
number
required
Opacity of the hidden state, 0 to 1.
Example:
0
textOverlay.animation.outro.preset
enum<string> | null
required
The preset the side matches, or null once its motion is custom.
Available options:
fade,
slide_up,
slide_down,
slide_left,
slide_right,
mask_up,
mask_down,
grow,
shrink,
blur,
blur_slide_up
Example:
"slide_up"
textOverlay.animation.outro.rotate
number
required
Clockwise rotation of the hidden state in degrees.
Example:
0
textOverlay.animation.outro.scale
number
required
Scale of the hidden state; 1 is its resting size.
Example:
1
textOverlay.animation.outro.text
object
The units a text side plays on, each in turn.
Hide child attributes
textOverlay.animation.outro.text.delayMs
integer
required
How long after one unit the next starts, in ms (0 to 2000).
Required range: 0 <= x <= 2000
Example:
100
textOverlay.animation.outro.text.order
enum<string>
required
Which unit goes first. random uses the same shuffle every time.
Available options:
forward,
backward,
center,
edges,
random
Example:
"forward"
textOverlay.animation.outro.text.smoothing
enum<string>
required
Eases the delays across the units: linear is an even step, the other curves bunch the starts up at one end.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
overshoot,
impulse,
swing
Example:
"linear"
textOverlay.animation.outro.text.unit
enum<string>
required
What animates on its own.
Available options:
letters,
words,
lines
Example:
"words"
textOverlay.animation.textIntro
object | null
required
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.
Hide child attributes
textOverlay.animation.textIntro.blur
number
required
Blur of the hidden state in pixels.
Example:
0
textOverlay.animation.textIntro.clip
boolean
required
Clip the motion to the overlay's box, so it wipes in like a mask.
Example:
false
textOverlay.animation.textIntro.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
Example:
500
textOverlay.animation.textIntro.easing
object
required
Hide child attributes
textOverlay.animation.textIntro.easing.curve
enum<string>
required
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.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
bounce,
overshoot,
impulse,
swing,
custom,
spring
Example:
"slow_down"
textOverlay.animation.textIntro.easing.intensity
number
required
How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.
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
textOverlay.animation.textIntro.moveY
number
required
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
textOverlay.animation.textIntro.opacity
number
required
Opacity of the hidden state, 0 to 1.
Example:
0
textOverlay.animation.textIntro.preset
enum<string> | null
required
The preset the side matches, or null once its motion is custom.
Available options:
fade,
slide_up,
slide_down,
slide_left,
slide_right,
mask_up,
mask_down,
grow,
shrink,
blur,
blur_slide_up
Example:
"slide_up"
textOverlay.animation.textIntro.rotate
number
required
Clockwise rotation of the hidden state in degrees.
Example:
0
textOverlay.animation.textIntro.scale
number
required
Scale of the hidden state; 1 is its resting size.
Example:
1
textOverlay.animation.textIntro.text
object
The units a text side plays on, each in turn.
Hide child attributes
textOverlay.animation.textIntro.text.delayMs
integer
required
How long after one unit the next starts, in ms (0 to 2000).
Required range: 0 <= x <= 2000
Example:
100
textOverlay.animation.textIntro.text.order
enum<string>
required
Which unit goes first. random uses the same shuffle every time.
Available options:
forward,
backward,
center,
edges,
random
Example:
"forward"
textOverlay.animation.textIntro.text.smoothing
enum<string>
required
Eases the delays across the units: linear is an even step, the other curves bunch the starts up at one end.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
overshoot,
impulse,
swing
Example:
"linear"
textOverlay.animation.textIntro.text.unit
enum<string>
required
What animates on its own.
Available options:
letters,
words,
lines
Example:
"words"
textOverlay.animation.textOutro
object | null
required
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.
Hide child attributes
textOverlay.animation.textOutro.blur
number
required
Blur of the hidden state in pixels.
Example:
0
textOverlay.animation.textOutro.clip
boolean
required
Clip the motion to the overlay's box, so it wipes in like a mask.
Example:
false
textOverlay.animation.textOutro.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
Example:
500
textOverlay.animation.textOutro.easing
object
required
Hide child attributes
textOverlay.animation.textOutro.easing.curve
enum<string>
required
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.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
bounce,
overshoot,
impulse,
swing,
custom,
spring
Example:
"slow_down"
textOverlay.animation.textOutro.easing.intensity
number
required
How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.
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
textOverlay.animation.textOutro.moveY
number
required
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
textOverlay.animation.textOutro.opacity
number
required
Opacity of the hidden state, 0 to 1.
Example:
0
textOverlay.animation.textOutro.preset
enum<string> | null
required
The preset the side matches, or null once its motion is custom.
Available options:
fade,
slide_up,
slide_down,
slide_left,
slide_right,
mask_up,
mask_down,
grow,
shrink,
blur,
blur_slide_up
Example:
"slide_up"
textOverlay.animation.textOutro.rotate
number
required
Clockwise rotation of the hidden state in degrees.
Example:
0
textOverlay.animation.textOutro.scale
number
required
Scale of the hidden state; 1 is its resting size.
Example:
1
textOverlay.animation.textOutro.text
object
The units a text side plays on, each in turn.
Hide child attributes
textOverlay.animation.textOutro.text.delayMs
integer
required
How long after one unit the next starts, in ms (0 to 2000).
Required range: 0 <= x <= 2000
Example:
100
textOverlay.animation.textOutro.text.order
enum<string>
required
Which unit goes first. random uses the same shuffle every time.
Available options:
forward,
backward,
center,
edges,
random
Example:
"forward"
textOverlay.animation.textOutro.text.smoothing
enum<string>
required
Eases the delays across the units: linear is an even step, the other curves bunch the starts up at one end.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
overshoot,
impulse,
swing
Example:
"linear"
textOverlay.animation.textOutro.text.unit
enum<string>
required
What animates on its own.
Available options:
letters,
words,
lines
Example:
"words"
textOverlay.background
object
required
Background behind the text. Overlays with no visible box report a solid #00000000.
Hide child attributes
textOverlay.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"
textOverlay.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"
textOverlay.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
textOverlay.backgroundShape
enum<string>
required
Shape of the solid background behind the text.
Available options:
none,
regular,
squircle
Example:
"squircle"
textOverlay.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"
textOverlay.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
textOverlay.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"
textOverlay.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
textOverlay.dimensions.height
number
required
Required range: x > 0
Example:
540
textOverlay.dimensions.width
number
required
Required range: x > 0
Example:
960
textOverlay.durationMs
number
required
Required range: x >= 0
Example:
5000
textOverlay.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"
textOverlay.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
textOverlay.fontWeight
number
required
Variable-font weight axis — 100 (thin) to 900 (black).
Example:
500
textOverlay.fontWidth
number
required
Variable-font width axis, as a percentage — 100 is normal, 50 ultra-condensed, 150 extra-expanded.
Example:
100
textOverlay.id
string
required
Text overlay ID
Example:
"ly_abc123"
textOverlay.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
textOverlay.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
textOverlay.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"
textOverlay.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
textOverlay.point.xPct
number
required
Example:
30
textOverlay.point.yPct
number
required
Example:
30
textOverlay.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"
textOverlay.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
textOverlay.text
string
required
Example:
"Welcome back"
textOverlay.textAlign
enum<string>
required
Horizontal alignment of the text inside its overlay box.
Available options:
left,
center,
right
Example:
"center"
textOverlay.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"
textOverlay.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
textOverlay.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
textOverlay.depthChanges.atMs
number
required
Ms after the overlay starts.
Required range: x >= 0
Example:
1200
textOverlay.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"
textOverlay.fontId
string
The library font the overlay renders with (a font item's id), absent for a catalog family.
Example:
"media_abc123def456"
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":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"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/clips/add-a-text-overlay-to-a-clip","slug":"/api-reference/clips/add-a-text-overlay-to-a-clip","pageMetadata":{"title":"Add a text overlay to a clip","description":"Adds a text overlay to a clip. Nothing needs uploading — pass the copy directly. Font, color, position and size all fall back to the editor's defaults.","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","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Adds a text overlay to a clip. Nothing needs uploading — pass the copy directly. Font, color, position and size all fall back to the editor’s defaults.\"\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":"Add a text overlay to a clip","description":"Adds a text overlay to a clip. Nothing needs uploading — pass the copy directly. Font, color, position and size all fall back to the editor's defaults.","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","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":"Adds a text overlay to a clip. Nothing needs uploading — pass the copy directly. Font, color, position and size all fall back to the editor's defaults.","operationId":"addClipTextOverlay","parameters":["836aba65-fc0c-45f5-b482-99d1f12d5b42","102e0208-348e-4a27-996d-a8b5310a9b2d"],"requestBody":"ce16b5cc-9473-4a8e-9d86-a56ecf891c60","responses":{"200":"e930eb6d-ba01-4571-b50b-4475c4e3aac7","400":"46543927-43a6-44ab-9c95-36bcdcef506f","401":"abeba89a-befb-4613-b032-3709e99dd462","403":"b60a00de-7ff4-4677-b074-17ba1203d854","404":"86a0e0b3-2480-418a-86ab-317e0a1ba302","409":"8adc2447-81ec-4000-8b2a-88267cd92162","429":"b88ab737-f526-427f-a4f3-004a035cd417","500":"04afc0b8-15cb-43f3-8cc3-19c3ac23a214","501":"ae79db03-5d08-4ed4-81ef-9a2607229fae","503":"c6530475-c0a6-4bcf-a4b2-2ffa8fbdf9ab"},"security":["5d7dab9d-3286-458d-8e7c-b4e7a29c5ac3"],"summary":"Add a text overlay to a clip","tags":["Clips"],"method":"post","type":"path","servers":["d2aabac2-b2bc-4b47-a6f4-a26614a56f79"],"path":"/v1/videos/{id}/clips/{clipId}/text-overlays","baseUrlOptions":["https://api.tella.com"],"title":"Add a text overlay to a clip","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.durationMs":5000,"body.startTimeMs":1000,"body.text":"Welcome back","body.animation.intro.oneOf.0.preset":"slide_up","body.animation.outro.oneOf.0.preset":"fade","body.backgroundPadding":0.25,"body.backgroundShape":"squircle","body.color":"#FFFFFFFF","body.cornerRadius":24,"body.depth":"behind_presenter","body.depthChanges.items.0.atMs":1200,"body.depthChanges.items.0.depth":"behind_presenter","body.fontFamily":"Inter","body.fontId":"media_abc123def456","body.fontSize":81,"body.fontWeight":500,"body.fontWidth":100,"body.letterSpacing":-0.02,"body.lineHeight":1.5,"body.outline.oneOf.0":"#000000FF","body.presetId":"default:label","body.shadow":"subtle","body.textAlign":"center","body.transition":"smooth"}],"urlDisplay":"full"},"dependencies":{"parameters":{"836aba65-fc0c-45f5-b482-99d1f12d5b42":{"description":"Video identifier","in":"path","name":"id","required":true,"schema":{"description":"Video identifier","example":"vid_abc123def456","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"102e0208-348e-4a27-996d-a8b5310a9b2d":{"description":"Clip identifier","in":"path","name":"clipId","required":true,"schema":{"description":"Clip identifier","example":"cl_xyz789ghi012","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Add a text overlay to a clip. Nothing needs uploading — pass the copy directly. When `point`/`dimensions` are omitted, a centered box 60% of the artboard wide and 25% tall is used.","properties":{"durationMs":{"example":5000,"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"durationMs","typeLabel":"integer"},"startTimeMs":{"description":"Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.","example":1000,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"startTimeMs","typeLabel":"integer"},"text":{"example":"Welcome back","minLength":1,"type":"string","isRequired":true,"uniqueKey":"text","typeLabel":"string"},"animation":{"type":"object","description":"How the overlay enters and leaves; when set it replaces `transition`. Each side describes the hidden state the overlay moves from on the way in and back to on the way out. An omitted side stays as it is. `{intro: {preset: 'slide_up'}, outro: {preset: 'fade'}}` is a complete animation; on text, `{textIntro: {preset: 'slide_up', text: {unit: 'words'}}}` brings the words in one by one.","example":{"intro":{"preset":"slide_up"},"outro":{"preset":"fade"}},"properties":{"intro":{"oneOf":[{"type":"object","description":"How the whole overlay enters, or null to appear instantly. Takes no `text`. Omit to keep the current intro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"animation.intro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"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. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"animation.intro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"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":"animation.intro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"animation.intro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"animation.intro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"animation.intro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"animation.intro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"animation.intro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"animation.intro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"animation.intro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"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.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"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.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"animation.intro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"animation.intro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"animation.intro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"animation.intro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"animation.intro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"animation.intro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"animation.intro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"animation.intro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"animation.intro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"animation.intro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"animation.intro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"animation.intro.oneOf.1","typeLabel":"null"}],"uniqueKey":"animation.intro","typeLabel":"object | null"},"motionBlur":{"description":"Blur the overlay along its motion while it moves, scales or turns. Defaults to true.","type":"boolean","uniqueKey":"animation.motionBlur","typeLabel":"boolean"},"outro":{"oneOf":[{"type":"object","description":"How the whole overlay leaves, or null to disappear instantly. Takes no `text`. Omit to keep the current outro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"animation.outro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"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. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"animation.outro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"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":"animation.outro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"animation.outro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"animation.outro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"animation.outro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"animation.outro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"animation.outro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"animation.outro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"animation.outro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"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.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"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.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"animation.outro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"animation.outro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"animation.outro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"animation.outro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"animation.outro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"animation.outro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"animation.outro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"animation.outro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"animation.outro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"animation.outro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"animation.outro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"animation.outro.oneOf.1","typeLabel":"null"}],"uniqueKey":"animation.outro","typeLabel":"object | null"},"textIntro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines enter, one after another, or null for none. Plays alongside `intro`: both start together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"animation.textIntro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"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. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"animation.textIntro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"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":"animation.textIntro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"animation.textIntro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"animation.textIntro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"animation.textIntro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"animation.textIntro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"animation.textIntro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"animation.textIntro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"animation.textIntro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"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.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"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.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"animation.textIntro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"animation.textIntro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"animation.textIntro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"animation.textIntro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"animation.textIntro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"animation.textIntro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"animation.textIntro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"animation.textIntro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"animation.textIntro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"animation.textIntro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"animation.textIntro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"animation.textIntro.oneOf.1","typeLabel":"null"}],"uniqueKey":"animation.textIntro","typeLabel":"object | null"},"textOutro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines leave, one after another, or null for none. Plays alongside `outro`: both end together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"animation.textOutro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"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. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"animation.textOutro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"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":"animation.textOutro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"animation.textOutro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"animation.textOutro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"animation.textOutro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"animation.textOutro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"animation.textOutro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"animation.textOutro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"animation.textOutro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"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.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"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.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"animation.textOutro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"animation.textOutro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"animation.textOutro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"animation.textOutro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"animation.textOutro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"animation.textOutro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"animation.textOutro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"animation.textOutro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"animation.textOutro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"animation.textOutro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"animation.textOutro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"animation.textOutro.oneOf.1","typeLabel":"null"}],"uniqueKey":"animation.textOutro","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"animation","typeLabel":"object"},"background":{"type":"object","description":"Background behind the text. Defaults to transparent.","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":"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":"background.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"background","typeLabel":"object"},"backgroundPadding":{"type":"number","description":"Defaults to 0, or the preset's.","maximum":1,"minimum":0,"example":0.25,"uniqueKey":"backgroundPadding","typeLabel":"number"},"backgroundShape":{"type":"string","description":"Defaults to none.","enum":["none","regular","squircle"],"example":"squircle","uniqueKey":"backgroundShape","typeLabel":"enum\u003cstring>"},"color":{"description":"Defaults to white.","example":"#FFFFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"color","typeLabel":"string"},"cornerRadius":{"type":"number","description":"Corner radius in story pixels, replacing the rounded shape's own (regular is 16 on a text background, squircle 32; on a square 12% and 24% of its shorter side). Needs a regular or squircle shape; setting the shape again without it goes back to the shape's own radius.","maximum":512,"minimum":0,"example":24,"uniqueKey":"cornerRadius","typeLabel":"number"},"depth":{"type":"string","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","uniqueKey":"depth","typeLabel":"enum\u003cstring>"},"depthChanges":{"type":"array","items":{"additionalProperties":false,"properties":{"atMs":{"description":"Ms after the overlay starts.","example":1200,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"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":"depthChanges.items.[INDEX].depth","typeLabel":"enum\u003cstring>"}},"required":["atMs","depth"],"type":"object","uniqueKey":"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":"depthChanges","typeLabel":"object[]"},"dimensions":{"type":"object","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.","required":["width","height"],"properties":{"height":{"example":540,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"dimensions.height","typeLabel":"number"},"width":{"example":960,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"dimensions.width","typeLabel":"number"}},"uniqueKey":"dimensions","typeLabel":"object"},"fontFamily":{"type":"string","description":"One of Tella's catalog font families. Defaults to Inter. Anything outside the catalog is rejected rather than silently falling back; use `fontId` for an uploaded font.","enum":["Inter","Roboto Mono","Archivo","Barlow","Caveat","DM Sans","Figtree","Lora","Merriweather","Montserrat","Nunito Sans","Open Sans","Oswald","Playfair Display","Poppins","Raleway","Roboto","Roboto Flex","Source Sans 3","Space Grotesk"],"example":"Inter","uniqueKey":"fontFamily","typeLabel":"enum\u003cstring>"},"fontId":{"type":"string","description":"A custom font from the private or workspace library: the `id` of a `font` item from GET /v1/library?type=font, such as one uploaded with POST /v1/sources (`kind: font`) and POST /v1/library. Sets the overlay's font family to that font. Don't combine with `fontFamily`.","minLength":1,"example":"media_abc123def456","uniqueKey":"fontId","typeLabel":"string"},"fontSize":{"description":"Font size in artboard pixels. Defaults to 7.5% of the video's shorter side, which is the editor's default and readable at any canvas size.","example":81,"exclusiveMinimum":true,"minimum":0,"type":"number","uniqueKey":"fontSize","typeLabel":"number"},"fontWeight":{"description":"Variable-font weight axis — 100 (thin) to 900 (black), 500 by default. Values outside the chosen font's own axis range are clamped when rendered.","example":500,"maximum":1000,"minimum":1,"type":"number","uniqueKey":"fontWeight","typeLabel":"number"},"fontWidth":{"description":"Variable-font width axis, as a percentage — 100 is normal, 50 ultra-condensed, 150 extra-expanded, 100 by default. Values outside the chosen font's own axis range are clamped when rendered.","example":100,"exclusiveMinimum":true,"minimum":0,"type":"number","uniqueKey":"fontWidth","typeLabel":"number"},"letterSpacing":{"type":"number","description":"Defaults to 0, or the preset's.","maximum":1,"minimum":-0.2,"example":-0.02,"uniqueKey":"letterSpacing","typeLabel":"number"},"lineHeight":{"type":"number","description":"Defaults to 1.2, or the preset's.","maximum":3,"minimum":0.8,"example":1.5,"uniqueKey":"lineHeight","typeLabel":"number"},"outline":{"oneOf":[{"type":"string","description":"Defaults to no outline, or the preset's.","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","example":"#000000FF","uniqueKey":"outline.oneOf.0","typeLabel":"string"},{"type":"null","description":"Defaults to no outline, or the preset's.","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","example":"#000000FF","uniqueKey":"outline.oneOf.1","typeLabel":"null"}],"uniqueKey":"outline","typeLabel":"string | null"},"point":{"type":"object","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.","required":["xPct","yPct"],"properties":{"xPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"point.xPct","typeLabel":"number"},"yPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"point.yPct","typeLabel":"number"}},"uniqueKey":"point","typeLabel":"object"},"presetId":{"description":"A preset from GET /v1/text-presets — `default:\u003cid>` for a built-in style or a saved preset's ID. Supplies the font, weight, width, color, size, alignment, tracking, background, background shape, background padding and outline (not the shadow); any of those fields sent alongside overrides the preset's value.","example":"default:label","minLength":1,"type":"string","uniqueKey":"presetId","typeLabel":"string"},"shadow":{"type":"string","description":"Defaults to none.","enum":["none","subtle","deep"],"example":"subtle","uniqueKey":"shadow","typeLabel":"enum\u003cstring>"},"textAlign":{"type":"string","description":"Defaults to center.","enum":["left","center","right"],"example":"center","uniqueKey":"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. An `animation` replaces it while set.","enum":["smooth","hard_cut"],"example":"smooth","uniqueKey":"transition","typeLabel":"enum\u003cstring>"}},"required":["text","startTimeMs","durationMs"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"durationMs":5000,"startTimeMs":1000,"text":"Welcome back","animation":{"intro":{"preset":"slide_up"},"outro":{"preset":"fade"}},"backgroundPadding":0.25,"backgroundShape":"squircle","color":"#FFFFFFFF","cornerRadius":24,"depth":"behind_presenter","depthChanges":[{"atMs":1200,"depth":"behind_presenter"}],"fontFamily":"Inter","fontId":"media_abc123def456","fontSize":81,"fontWeight":500,"fontWidth":100,"letterSpacing":-0.02,"lineHeight":1.5,"outline":"#000000FF","presetId":"default:label","shadow":"subtle","textAlign":"center","transition":"smooth"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"e930eb6d-ba01-4571-b50b-4475c4e3aac7":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"A text overlay on a clip","properties":{"textOverlay":{"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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"textOverlay.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"textOverlay.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"textOverlay.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"textOverlay.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"textOverlay.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":"textOverlay.animation.oneOf.0.intro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.intro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.intro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"textOverlay.animation.oneOf.0.intro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.animation.oneOf.0.intro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.intro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.animation.oneOf.0.intro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"textOverlay.animation.oneOf.0.intro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.intro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.intro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"textOverlay.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"textOverlay.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"textOverlay.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"textOverlay.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"textOverlay.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":"textOverlay.animation.oneOf.0.outro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.outro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.outro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"textOverlay.animation.oneOf.0.outro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.animation.oneOf.0.outro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.outro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.animation.oneOf.0.outro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"textOverlay.animation.oneOf.0.outro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.outro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.outro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"textOverlay.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"textOverlay.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"textOverlay.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"textOverlay.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"textOverlay.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":"textOverlay.animation.oneOf.0.textIntro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.textIntro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.textIntro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"textOverlay.animation.oneOf.0.textIntro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.animation.oneOf.0.textIntro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.textIntro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.animation.oneOf.0.textIntro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"textOverlay.animation.oneOf.0.textIntro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.textIntro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.textIntro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"textOverlay.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"textOverlay.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"textOverlay.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"textOverlay.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"textOverlay.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":"textOverlay.animation.oneOf.0.textOutro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.textOutro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.textOutro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"textOverlay.animation.oneOf.0.textOutro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.animation.oneOf.0.textOutro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.textOutro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.animation.oneOf.0.textOutro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"textOverlay.animation.oneOf.0.textOutro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.textOutro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.textOutro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0.textOutro","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"textOverlay.animation.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.background.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.backgroundPadding","typeLabel":"number"},"backgroundShape":{"description":"Shape of the solid background behind the text.","enum":["none","regular","squircle"],"example":"squircle","type":"string","isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.cornerRadius.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"textOverlay.cornerRadius.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.dimensions.height","typeLabel":"number"},"width":{"example":960,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"textOverlay.dimensions.width","typeLabel":"number"}},"required":["width","height"],"type":"object","isRequired":true,"uniqueKey":"textOverlay.dimensions","typeLabel":"object"},"durationMs":{"example":5000,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.fontSize","typeLabel":"number"},"fontWeight":{"description":"Variable-font weight axis — 100 (thin) to 900 (black).","example":500,"type":"number","isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.fontWidth","typeLabel":"number"},"id":{"description":"Text overlay ID","example":"ly_abc123","type":"string","isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.outline.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.point.xPct","typeLabel":"number"},"yPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"textOverlay.point.yPct","typeLabel":"number"}},"required":["xPct","yPct"],"type":"object","isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.startTimeMs","typeLabel":"number"},"text":{"example":"Welcome back","type":"string","isRequired":true,"uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.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":"textOverlay.depthChanges.items.[INDEX].depth","typeLabel":"enum\u003cstring>"}},"required":["atMs","depth"],"type":"object","uniqueKey":"textOverlay.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":"textOverlay.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":"textOverlay.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","isRequired":true,"uniqueKey":"textOverlay","typeLabel":"object"}},"required":["textOverlay"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"textOverlay":{"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"}}}},"exampleType":"generated"}},"description":"OK","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"},"46543927-43a6-44ab-9c95-36bcdcef506f":{"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"},"abeba89a-befb-4613-b032-3709e99dd462":{"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"},"b60a00de-7ff4-4677-b074-17ba1203d854":{"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"},"86a0e0b3-2480-418a-86ab-317e0a1ba302":{"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"},"8adc2447-81ec-4000-8b2a-88267cd92162":{"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"},"b88ab737-f526-427f-a4f3-004a035cd417":{"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"},"04afc0b8-15cb-43f3-8cc3-19c3ac23a214":{"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"},"ae79db03-5d08-4ed4-81ef-9a2607229fae":{"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"},"c6530475-c0a6-4bcf-a4b2-2ffa8fbdf9ab":{"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":{"5d7dab9d-3286-458d-8e7c-b4e7a29c5ac3":{"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":"Add a text overlay to a clip - Tella","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{},"searchTabScopes":[{"tab":"Help Center"},{"tab":"Developers"},{"tab":"Changelog"}]},"originalFileLocation":"api-reference/clips/add-a-text-overlay-to-a-clip.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=\"Adds a text overlay to a clip. Nothing needs uploading — pass the copy directly. Font, color, position and size all fall back to the editor\u0026#x27;s defaults.\">\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=\"Add a text overlay to a clip - Tella\">\u003cmeta data-mint-head property=\"og:description\" content=\"Adds a text overlay to a clip. Nothing needs uploading — pass the copy directly. Font, color, position and size all fall back to the editor\u0026#x27;s defaults.\">\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/clips/add-a-text-overlay-to-a-clip\">\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=Clips\u0026amp;title=Add+a+text+overlay+to+a+clip\u0026amp;description=Adds+a+text+overlay+to+a+clip.+Nothing+needs+uploading+%E2%80%94+pass+the+copy+directly.+Font%2C+color%2C+position+and+size+all+fall+back+to+the+editor%27s+defaults.\u0026amp;theme=83fc5c73f5b3900df40eca67\u0026amp;signature=94ac359d11deb5b4d5a055283a6051bbc84fd19f49d1604d93f3b6c3be491e8b\">\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=\"Add a text overlay to a clip - Tella\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Adds a text overlay to a clip. Nothing needs uploading — pass the copy directly. Font, color, position and size all fall back to the editor\u0026#x27;s defaults.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tella.mintlify.site/docs/_mintlify/api/og/v2?division=Clips\u0026amp;title=Add+a+text+overlay+to+a+clip\u0026amp;description=Adds+a+text+overlay+to+a+clip.+Nothing+needs+uploading+%E2%80%94+pass+the+copy+directly.+Font%2C+color%2C+position+and+size+all+fall+back+to+the+editor%27s+defaults.\u0026amp;theme=83fc5c73f5b3900df40eca67\u0026amp;signature=94ac359d11deb5b4d5a055283a6051bbc84fd19f49d1604d93f3b6c3be491e8b\">\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/clips/add-a-text-overlay-to-a-clip\">\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/clips/add-a-text-overlay-to-a-clip.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/clips/add-a-text-overlay-to-a-clip#webpage\",\"url\":\"https://www.tella.com/docs/api-reference/clips/add-a-text-overlay-to-a-clip\",\"name\":\"Add a text overlay to a clip\",\"description\":\"Adds a text overlay to a clip. Nothing needs uploading — pass the copy directly. Font, color, position and size all fall back to the editor's defaults.\",\"isPartOf\":{\"@id\":\"https://www.tella.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.tella.com/docs/api-reference/clips/add-a-text-overlay-to-a-clip#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.tella.com/docs/api-reference/clips/add-a-text-overlay-to-a-clip#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\":\"Clips\",\"item\":\"https://www.tella.com/docs/api-reference/clips/list-text-presets\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Add a text overlay to a clip\",\"item\":\"https://www.tella.com/docs/api-reference/clips/add-a-text-overlay-to-a-clip\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.tella.com/docs/api-reference/clips/add-a-text-overlay-to-a-clip#apireference\",\"headline\":\"Add a text overlay to a clip\",\"name\":\"Add a text overlay to a clip\",\"description\":\"Adds a text overlay to a clip. Nothing needs uploading — pass the copy directly. Font, color, position and size all fall back to the editor's defaults.\",\"url\":\"https://www.tella.com/docs/api-reference/clips/add-a-text-overlay-to-a-clip\",\"mainEntityOfPage\":{\"@id\":\"https://www.tella.com/docs/api-reference/clips/add-a-text-overlay-to-a-clip#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/clips/add-a-text-overlay-to-a-clip.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","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)","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","description":"Returns the 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","description":"Removes a text overlay from a clip.","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":"Add a text overlay to a clip - 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"]}