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

# Projekteinstellungen

> Die aktiven Einstellungen eines Projekts lesen und patchen

Jedes Projekt hat aktive Einstellungen — Trim, Hintergrund, Untertitelstil, Layout — die steuern, wie Exporte gerendert werden. Verwende Projekteinstellungen, wenn du projektlokale Overrides möchtest, die sich nicht als Preset zu teilen lohnen.

Siehe [Referenz für Render-Einstellungen](/en/render-settings-reference) für die gemeinsame Feldzuordnung von
`preset`, `settings.style` und `settingsOverride`.

## Endpoints

| Method  | Path                             | Zweck                                                   |
| ------- | -------------------------------- | ------------------------------------------------------- |
| `GET`   | `/projects/{projectId}/settings` | Die aktiven Projekteinstellungen abrufen.               |
| `PATCH` | `/projects/{projectId}/settings` | Ein Preset anwenden, Einstellungen patchen oder beides. |

Vollständige Request- und Response-Schemas findest du in der **API reference**.

## Aktuelle Einstellungen abrufen

```bash theme={null}
curl https://api.youka.io/de/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..."
```

Gibt die vollständigen aktiven Projekteinstellungen zurück, einschließlich eines ggf. angewendeten Presets.

## Einstellungen patchen

`PATCH` akzeptiert jede Teilmenge von `presetId` und `settings`. Wenn beide übergeben werden, wird zuerst das Preset angewendet und anschließend werden `settings` darüber gemergt.

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

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

## Gültige Felder ermitteln

Das SDK exportiert das Schema, das Updates der Projekteinstellungen validiert. Wandle es zur Laufzeit in JSON Schema um:

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

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

<Tip>
  Agents sollten das SDK-Schema oder das OpenAPI-Request-Schema abrufen, bevor sie
  Projekteinstellungen mutieren, damit sie die aktuelle Struktur immer kennen.
</Tip>

Referenz (für Menschen lesbar):

* [Referenz für Render-Einstellungen](/en/render-settings-reference)
* [CLI projects](/de/cli/projects)
* [SDK project settings](/de/sdk/project-settings)

## Projekteinstellungen vs Presets vs Export-Overrides

Youka hat drei Ebenen, in denen Render-Einstellungen liegen können:

| Ebene                         | Geltungsbereich | Wann verwenden                                                     |
| ----------------------------- | --------------- | ------------------------------------------------------------------ |
| **Preset**                    | Konto-weit      | Der gleiche Look über viele Projekte hinweg.                       |
| **Projekteinstellungen**      | Ein Projekt     | Projektspezifischer Trim, Hintergrund oder Farbe.                  |
| **Export `settingsOverride`** | Nur ein Export  | Einen einzelnen Render feinjustieren, ohne das Projekt anzufassen. |

Jede Ebene wird zur Exportzeit in dieser Reihenfolge gemergt.

## Wie geht’s weiter

* [Referenz für Render-Einstellungen](/en/render-settings-reference) — alle gemeinsamen Feldpfade und Enum-Werte
* [Presets](/de/api/presets) — wiederverwendbare Konfigurationen
* [Media](/de/api/media) — referenziert aus den Einstellungen
* [CLI projects](/de/cli/projects) — derselbe Ablauf aus dem Terminal
* [SDK project settings](/de/sdk/project-settings) — dieselben Endpoints in TypeScript