Configuración del proyecto

Cada proyecto tiene una configuración activa — recorte, fondo, estilo de subtítulos, diseño — que controla cómo se renderizan las exportaciones. Usa la configuración del proyecto cuando quieras sobrescrituras locales del proyecto que no valga la pena compartir como un preset. Consulta Render settings reference para el mapa de campos compartidos de preset, settings.style y settingsOverride.

Endpoints

Method	Path	Purpose
`GET`	`/projects/{projectId}/settings`	Obtener la configuración activa del proyecto.
`PATCH`	`/projects/{projectId}/settings`	Aplicar un preset, modificar la configuración o ambos.

Los esquemas completos de solicitud y respuesta están en API reference.

Obtener la configuración actual

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

Devuelve la configuración activa completa del proyecto, incluido cualquier preset que esté aplicado.

Modificar la configuración

PATCH acepta cualquier subconjunto de presetId y settings. Cuando se pasan ambos, primero se aplica el preset y luego settings se combina por encima.

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 }
    }
  }'

Descubrir campos válidos

El SDK exporta el esquema que valida las actualizaciones de configuración del proyecto. Conviértelo a JSON Schema en tiempo de ejecución:

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

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();

Los agentes deberían obtener el esquema del SDK o el esquema de solicitud de OpenAPI antes de modificar la configuración del proyecto para que siempre conozcan la forma actual.

Referencia legible para humanos: