Skip to main content
A preset is a reusable render configuration — background, subtitle style, layout, and other visual settings — that you can apply to any project or export. Presets are ideal when you have a consistent look across many tracks. See Render settings reference for the full preset shape and every enum-backed option.

​
preset schema

Return the JSON Schema for preset settings. Use this to discover valid fields before creating or updating a preset. 
youka preset schema --json
Agents should call preset schema before mutating presets so they know the exact field names and value types.

​
preset list

List all presets owned by the authenticated account. 
youka preset list --json

​
preset show

Fetch a single preset by ID. 
youka preset show <presetId> --json

​
preset create

Create a new preset. 
youka preset create [options]

​
Options

OptionDescription
--name <name>Preset name
--defaultMark the new preset as the default
--body <file|->Read the full request body from a file or stdin
The request body should contain the full preset object. For large payloads, prefer --body instead of inline JSON.

​
Examples

youka preset create \
  --name "Neon Night" \
  --body ./neon-preset.json \
  --json
CLI flags override matching fields from --body.

​
preset update

Update an existing preset. 
youka preset update <presetId> [options]
OptionDescription
--name <name>New name
--body <file|->Full request body from file or stdin
Example: 
youka preset update $PRESET_ID \
  --name "Neon Night v2" \
  --body ./neon-v2.json \
  --json

​
preset delete

Delete a preset by ID. 
youka preset delete <presetId> --json
Deleting a preset does not delete projects or exports that were previously rendered with it. Future exports that reference the deleted preset will fail.

​
preset default

Get or set the default preset. 
youka preset default --json
youka preset default <presetId> --json
With no argument, the command returns the current default preset or null. With a preset ID, it marks that preset as the default.

​
Applying a preset

Apply a preset to a project or export with --preset: 
youka project create ./song.mp3 --preset $PRESET_ID --wait

​
What’s next