API Reference
Get Preset
Retrieve a single preset by its ID
GET
Get Preset
Retrieve a single preset from your library. Presets are created in the Submagic editor and bundle the settings and media (caption theme, hook, logo, music, and more) applied to new projects.This endpoint requires authentication and has a rate limit of 1000 requests
per hour.
Authentication
string
required
Your Submagic API key starting with
sk-Path Parameters
string
required
The unique identifier (UUID) of the preset to retrieve
Response
string
Unique identifier for the preset (UUID format)
string
Preset name
string
Preset description. Omitted when not set.
boolean
Whether projects created with this preset get its saved caption theme
boolean
Whether projects created with this preset get its saved hook title
boolean
Whether Magic Zooms are enabled
boolean
Whether AI Auto B-rolls are enabled
number
How much of the video AI Auto B-rolls cover, as a percentage (0-100). Omitted
when not set.
boolean
Whether AI Auto B-rolls use transition effects between clips. Omitted when not
set.
boolean
Whether projects created with this preset get its saved logo
boolean
Whether projects created with this preset get its saved color filter
boolean
Whether Clean Audio is enabled
boolean
Whether Eye Contact correction is enabled
boolean
Whether projects created with this preset get its saved background music
number
Background music volume, 1-100. Omitted when the preset has no saved music.
number
Volume applied to transition sounds, 0-100. Omitted when not set.
object
Which gated settings have saved config, i.e. which toggles can be enabled on
Update Preset.
string
ID of the project the preset was created from
string
ISO 8601 timestamp when the preset was created
string
ISO 8601 timestamp when the preset was last updated

