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.

backgroundPadding
number

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

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"

cornerRadius
number | null

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

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
letterSpacing
number

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

lineHeight
number

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

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