> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuración del proyecto

> Leer y modificar la configuración activa de un 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](/en/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 ambas cosas. |

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

## Obtener la configuración actual

```bash theme={null}
curl https://api.youka.io/es/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 fusiona encima.

<Tabs>
  <Tab title="Apply a preset">
    ```bash theme={null}
    curl -X PATCH https://api.youka.io/es/api/v1/projects/prj_abc/settings \
      -H "Authorization: Bearer yk_..." \
      -H "Content-Type: application/json" \
      -d '{
        "presetId": "preset_abc123"
      }'
    ```
  </Tab>

  <Tab title="Inline settings">
    ```bash theme={null}
    curl -X PATCH https://api.youka.io/es/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"
            }
          }
        }
      }'
    ```
  </Tab>

  <Tab title="Preset + overrides">
    ```bash theme={null}
    curl -X PATCH https://api.youka.io/es/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 }
        }
      }'
    ```
  </Tab>
</Tabs>

## 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:

```ts theme={null}
import { RestUpdateProjectSettingsRequestSchema } from "@youka/sdk";

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();
```

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

Referencia legible para humanos:

* [Render settings reference](/en/render-settings-reference)
* [CLI projects](/es/cli/projects)
* [SDK project settings](/es/sdk/project-settings)

## Configuración del proyecto vs presets vs sobrescrituras de exportación

Youka tiene tres capas en las que pueden vivir los ajustes de renderizado:

| Layer                         | Scope                | When to use                                      |
| ----------------------------- | -------------------- | ------------------------------------------------ |
| **Preset**                    | En toda la cuenta    | El mismo aspecto en muchos proyectos.            |
| **Project settings**          | Un proyecto          | Recorte, fondo o color específicos del proyecto. |
| **Export `settingsOverride`** | Una sola exportación | Ajustar un render único sin tocar el proyecto.   |

Cada capa se fusiona en ese orden en el momento de exportación.

## Qué sigue

* [Render settings reference](/en/render-settings-reference) — todas las rutas de campos compartidas y los valores enum
* [Presets](/es/api/presets) — configuraciones reutilizables
* [Media](/es/api/media) — referenciado desde settings
* [CLI projects](/es/cli/projects) — el mismo flujo desde la terminal
* [SDK project settings](/es/sdk/project-settings) — los mismos endpoints en TypeScript