# Update template settings

Apply one or more settings sections. Subtitle PATCH names differ from creation preConfigs: use fontSize/textColor/highlightColor here. libraryTrack selects one verified shared-library track. Unknown top-level sections are rejected.

Endpoint: PATCH /auth/organization/{organizationId}/workspace/{workspaceId}/templates/{templateId}/settings
Version: 1.3.0
Security: ShuffllApiKey

## Security:

  - `ShuffllApiKey` (unknown)
    apiKey in header x-api-key

## Path parameters:

  - `organizationId` (string, required)
    Unique identifier for the organization

  - `workspaceId` (string, required)
    Unique identifier for the workspace

  - `templateId` (string, required)
    Unique identifier for the template

## Request fields (application/json):

  - `subtitles` (object)

  - `subtitles.strategy` (string)

  - `subtitles.maxWords` (integer)

  - `subtitles.fontName` (string)

  - `subtitles.fontSize` (number)

  - `subtitles.bold` (boolean)

  - `subtitles.italic` (boolean)

  - `subtitles.underline` (boolean)

  - `subtitles.alignment` (string)
    Enum: "left", "center", "right"

  - `subtitles.offset` (number)

  - `subtitles.textColor` (string)
    CSS #RRGGBBAA color including alpha, e.g. #FFFFFFFF.

  - `subtitles.highlightColor` (string)
    CSS #RRGGBBAA color including alpha, e.g. #FFFFFFFF.

  - `subtitles.outlineEnabled` (boolean)

  - `subtitles.outlineWidth` (number)

  - `subtitles.outlineColor` (string)
    CSS #RRGGBBAA color including alpha, e.g. #FFFFFFFF.

  - `subtitles.boxEnabled` (boolean)

  - `subtitles.boxWidth` (number)

  - `subtitles.boxColor` (string)
    CSS #RRGGBBAA color including alpha, e.g. #FFFFFFFF.

  - `subtitles.shadowEnabled` (boolean)

  - `subtitles.shadowDepth` (number)

  - `subtitles.shadowEffect` (object)

  - `subtitles.shadowEffect.xshad` (number, required)

  - `subtitles.shadowEffect.yshad` (number, required)

  - `subtitles.shadowEffect.blur` (number, required)

  - `subtitles.shadowEffect.color` (string, required)
    CSS #RRGGBBAA color including alpha, e.g. #FFFFFFFF.

  - `subtitles.shadowEffect.shouldAffectBoxedText` (boolean, required)

  - `subtitles.boxHighlight` (object)

  - `subtitles.boxHighlight.enabled` (boolean, required)

  - `subtitles.boxHighlight.color` (string, required)
    CSS #RRGGBBAA color including alpha, e.g. #FFFFFFFF.

  - `subtitles.boxHighlight.opacity` (number, required)

  - `subtitles.boxHighlight.paddingX` (number, required)

  - `subtitles.boxHighlight.paddingY` (number, required)

  - `subtitles.boxHighlight.borderRadius` (number, required)

  - `subtitles.boxHighlight.animated` (boolean, required)

  - `subtitles.boxHighlight.animationDuration` (number, required)

  - `subtitles.boxHighlight.renderWidthScaleByFont` (object)

  - `bgMusic` (object)

  - `bgMusic.type` (string)
    Enum: "file", "libraryTrack", "folder", "llm"

  - `bgMusic.assetId` (string)
    Required for file mode.

  - `bgMusic.libraryTrackId` (string)
    Required for libraryTrack mode. Use the opaque music-library track ID.

  - `bgMusic.folderName` (string)
    Library group name, required for folder mode.

  - `bgMusic.volume` (number)

  - `bgMusic.isOn` (boolean)

  - `bgMusic.toLoopIfFinished` (boolean)

  - `watermark` (object)

  - `watermark.assetId` (string)

  - `watermark.x` (number)

  - `watermark.y` (number)

  - `assetMapping` (object)

  - `assetMapping.assetsToScenesStrategy` (string)

  - `assetMapping.minFitScore` (number)

  - `assetMapping.fitScoreWeight` (number)

  - `assetMapping.qualityScoreWeight` (number)

  - `fonts` (object)
    Template font roles and application rules.

  - `aiVoice` (object)
    AI voice action update.

  - `aiVoice.key` (string, required)
    AI voice setting name, e.g. voiceId or voiceSpeed.

  - `aiVoice.value` (any, required)
    Value for the selected setting.

  - `socketIdToExclude` (string | null)

## Response 200:

  - `200` (unknown)
    Updated platform template

## Response 400:

  - `400` (unknown)
    Invalid settings

## Response 404:

  - `404` (unknown)
    Template or music track not found