Skip to main content
POST
Save a text preset

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Body

application/json

Save a personal text preset. The style starts from the given text overlay, else from the editor's default text look; every style field sent alongside overrides it.

name
string
required
Required string length: 1 - 255
Example:

"Product callout"

background
object

Background behind a text overlay, in the same object shape as a clip background.

backgroundShape
enum<string>

Shape of the solid background behind the text.

Available options:
none,
regular,
squircle
Example:

"squircle"

color
string

Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.

Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:

"#FFFFFFFF"

fontFamily
enum<string>

One of Tella's catalog font families — the same list the editor's font picker offers.

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"

fontSizeScale
number

Font size relative to the editor's default (7.5% of the canvas's shorter side): 1 is the default, 0.6 a caption, 1.4 a headline. Presets are video-independent, so this is a scale rather than pixels; adding an overlay resolves it for the video it lands on.

Required range: x > 0
Example:

0.6

fontWeight
number
Required range: 1 <= x <= 1000
fontWidth
number
Required range: x > 0
outline
string | null

Outline color, or null for none.

Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:

"#000000FF"

textAlign
enum<string>

Horizontal alignment of the text inside its overlay box.

Available options:
left,
center,
right
Example:

"center"

textOverlayId
string

Text overlay to copy the style from, keeping a custom font and reading its size relative to that video's canvas. Goes together with videoId.

Example:

"ly_abc123"

videoId
string

Video holding the text overlay to copy the style from. Goes together with textOverlayId.

Example:

"vid_abc123"

Response

Preset saved

preset
object
required
Last modified on October 6, 2026