Project settings

Every project has active settings — trim, background, subtitle style, layout — that control how exports are rendered. Use project settings when you want project-local overrides that aren’t worth sharing as a preset. See Render settings reference for the shared preset, settings.style, and settingsOverride field map.

Endpoints

Method	Path	Purpose
`GET`	`/projects/{projectId}/settings`	Fetch the active project settings.
`PATCH`	`/projects/{projectId}/settings`	Apply a preset, patch settings, or both.

Full request and response schemas are in API reference.

Fetch the current settings

curl https://api.youka.io/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..."

Returns the full active project settings, including any preset that is applied.

Patch the settings

PATCH accepts any subset of presetId and settings. When both are passed, the preset is applied first and then settings is merged on top.

Apply a preset
Inline settings
Preset + overrides

curl -X PATCH https://api.youka.io/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "presetId": "preset_abc123"
  }'

curl -X PATCH https://api.youka.io/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "settings": {
      "trim": { "startSeconds": 5, "endSeconds": 180 },
      "style": {
        "background": {
          "type": "color",
          "color": "#101010"
        }
      }
    }
  }'

curl -X PATCH https://api.youka.io/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "presetId": "preset_abc123",
    "settings": {
      "trim": { "startSeconds": 5, "endSeconds": 180 }
    }
  }'

Discover valid fields

The SDK exports the schema that validates project settings updates. Convert it to JSON Schema at runtime:

import { RestUpdateProjectSettingsRequestSchema } from "@youka/sdk";

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();

Agents should fetch the SDK schema or the OpenAPI request schema before mutating project settings so they always know the current shape.

Human-readable reference: