curl -X PUT "https://api.submagic.co/v1/presets/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My TikTok Preset",
    "magicZooms": true,
    "music": true,
    "musicVolume": 25
  }'

const updatePreset = async (presetId, updateData) => {
  const response = await fetch(
    `https://api.submagic.co/v1/presets/${presetId}`,
    {
      method: "PUT",
      headers: {
        "x-api-key": "sk-your-api-key-here",
        "Content-Type": "application/json",
      },
      body: JSON.stringify(updateData),
    }
  );

  return response.json();
};

const preset = await updatePreset("550e8400-e29b-41d4-a716-446655440000", {
  name: "My TikTok Preset",
  magicZooms: true,
  music: true,
  musicVolume: 25,
});

import requests

def update_preset(preset_id, update_data):
    url = f'https://api.submagic.co/v1/presets/{preset_id}'
    headers = {
        'x-api-key': 'sk-your-api-key-here',
        'Content-Type': 'application/json'
    }

    response = requests.put(url, headers=headers, json=update_data)
    return response.json()

preset = update_preset('550e8400-e29b-41d4-a716-446655440000', {
    'name': 'My TikTok Preset',
    'magicZooms': True,
    'music': True,
    'musicVolume': 25
})

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My TikTok Preset",
  "captions": true,
  "hookTitle": true,
  "magicZooms": true,
  "magicBrolls": false,
  "logo": false,
  "colorFilter": false,
  "cleanAudio": true,
  "eyeContactCorrection": false,
  "music": true,
  "musicVolume": 25,
  "configured": {
    "captions": true,
    "hookTitle": true,
    "logo": false,
    "colorFilter": false,
    "music": true
  },
  "sourceProjectId": "88a08eec-712a-45d0-8d0b-3b631700cb3a",
  "createdAt": "2024-01-10T08:00:00.000Z",
  "updatedAt": "2024-01-12T09:30:00.000Z"
}

{
  "error": "VALIDATION_ERROR",
  "message": "Cannot enable music: this preset has no saved music"
}

{
  "error": "NOT_FOUND",
  "message": "Preset not found"
}

PUT

presets

{id}

curl -X PUT "https://api.submagic.co/v1/presets/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My TikTok Preset",
    "magicZooms": true,
    "music": true,
    "musicVolume": 25
  }'

const updatePreset = async (presetId, updateData) => {
  const response = await fetch(
    `https://api.submagic.co/v1/presets/${presetId}`,
    {
      method: "PUT",
      headers: {
        "x-api-key": "sk-your-api-key-here",
        "Content-Type": "application/json",
      },
      body: JSON.stringify(updateData),
    }
  );

  return response.json();
};

const preset = await updatePreset("550e8400-e29b-41d4-a716-446655440000", {
  name: "My TikTok Preset",
  magicZooms: true,
  music: true,
  musicVolume: 25,
});

import requests

def update_preset(preset_id, update_data):
    url = f'https://api.submagic.co/v1/presets/{preset_id}'
    headers = {
        'x-api-key': 'sk-your-api-key-here',
        'Content-Type': 'application/json'
    }

    response = requests.put(url, headers=headers, json=update_data)
    return response.json()

preset = update_preset('550e8400-e29b-41d4-a716-446655440000', {
    'name': 'My TikTok Preset',
    'magicZooms': True,
    'music': True,
    'musicVolume': 25
})

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My TikTok Preset",
  "captions": true,
  "hookTitle": true,
  "magicZooms": true,
  "magicBrolls": false,
  "logo": false,
  "colorFilter": false,
  "cleanAudio": true,
  "eyeContactCorrection": false,
  "music": true,
  "musicVolume": 25,
  "configured": {
    "captions": true,
    "hookTitle": true,
    "logo": false,
    "colorFilter": false,
    "music": true
  },
  "sourceProjectId": "88a08eec-712a-45d0-8d0b-3b631700cb3a",
  "createdAt": "2024-01-10T08:00:00.000Z",
  "updatedAt": "2024-01-12T09:30:00.000Z"
}

{
  "error": "VALIDATION_ERROR",
  "message": "Cannot enable music: this preset has no saved music"
}

{
  "error": "NOT_FOUND",
  "message": "Preset not found"
}

Update Preset

Update the settings on an existing preset. Only the toggles and values below can be changed — the preset’s saved media (caption theme, hook, logo, color filter, music) is created in the editor and cannot be replaced through the API.

This endpoint requires authentication and has a rate limit of 500 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 update

Request Body

All fields are optional, but you must provide at least one. A toggle that depends on saved media can only be enabled when the preset has that media — check the configured object from Get Preset first, otherwise the request fails with VALIDATION_ERROR.

string

Preset name (1-100 characters)

string | null

Preset description (up to 500 characters). Pass null to clear it.

boolean

Whether projects created with this preset get its saved caption theme. Can only be enabled if configured.captions is true.

boolean

Whether projects created with this preset get its saved hook title. Can only be enabled if configured.hookTitle is true.

boolean

Whether Magic Zooms are enabled.

boolean

AI Auto B-rolls: Submagic automatically picks the moments and inserts b-roll across the whole video.

number

How much of the video AI Auto B-rolls should cover, as a percentage (0-100). Only used together with magicBrolls: true.

boolean

Whether AI Auto B-rolls use transition effects between clips.

boolean

Whether projects created with this preset get its saved logo. Can only be enabled if configured.logo is true.

boolean

Whether projects created with this preset get its saved color filter. Can only be enabled if configured.colorFilter is true.

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. Can only be enabled if configured.music is true.

number

Background music volume, 1-100. Can only be set if configured.music is true.

number | null

Volume applied to all transition sounds, 0-100. Pass null to turn transition sounds off.

Response

Returns the updated preset. See Get Preset for the full object shape.

curl -X PUT "https://api.submagic.co/v1/presets/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My TikTok Preset",
    "magicZooms": true,
    "music": true,
    "musicVolume": 25
  }'

const updatePreset = async (presetId, updateData) => {
  const response = await fetch(
    `https://api.submagic.co/v1/presets/${presetId}`,
    {
      method: "PUT",
      headers: {
        "x-api-key": "sk-your-api-key-here",
        "Content-Type": "application/json",
      },
      body: JSON.stringify(updateData),
    }
  );

  return response.json();
};

const preset = await updatePreset("550e8400-e29b-41d4-a716-446655440000", {
  name: "My TikTok Preset",
  magicZooms: true,
  music: true,
  musicVolume: 25,
});

import requests

def update_preset(preset_id, update_data):
    url = f'https://api.submagic.co/v1/presets/{preset_id}'
    headers = {
        'x-api-key': 'sk-your-api-key-here',
        'Content-Type': 'application/json'
    }

    response = requests.put(url, headers=headers, json=update_data)
    return response.json()

preset = update_preset('550e8400-e29b-41d4-a716-446655440000', {
    'name': 'My TikTok Preset',
    'magicZooms': True,
    'music': True,
    'musicVolume': 25
})

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My TikTok Preset",
  "captions": true,
  "hookTitle": true,
  "magicZooms": true,
  "magicBrolls": false,
  "logo": false,
  "colorFilter": false,
  "cleanAudio": true,
  "eyeContactCorrection": false,
  "music": true,
  "musicVolume": 25,
  "configured": {
    "captions": true,
    "hookTitle": true,
    "logo": false,
    "colorFilter": false,
    "music": true
  },
  "sourceProjectId": "88a08eec-712a-45d0-8d0b-3b631700cb3a",
  "createdAt": "2024-01-10T08:00:00.000Z",
  "updatedAt": "2024-01-12T09:30:00.000Z"
}

{
  "error": "VALIDATION_ERROR",
  "message": "Cannot enable music: this preset has no saved music"
}

{
  "error": "NOT_FOUND",
  "message": "Preset not found"
}

Get Preset Export Project

Get Started

Guides

API Reference

Update Preset

Update Preset

Authentication

Path Parameters

Request Body

Response

​Update Preset

​Authentication

​Path Parameters

​Request Body

​Response

Update Preset

Authentication

Path Parameters

Request Body

Response