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

# प्रोजेक्ट सेटिंग्स

> किसी प्रोजेक्ट की सक्रिय सेटिंग्स पढ़ें और पैच करें

हर प्रोजेक्ट में सक्रिय सेटिंग्स होती हैं — trim, background, subtitle style, layout — जो यह नियंत्रित करती हैं कि exports कैसे render होते हैं। जब आपको ऐसे project-local overrides चाहिए हों जिन्हें preset के रूप में साझा करना सार्थक न हो, तब project settings का उपयोग करें।

शेयर्ड `preset`, `settings.style`, और `settingsOverride` फ़ील्ड मैप के लिए [Render settings reference](/en/render-settings-reference) देखें।

## Endpoints

| Method  | Path                             | Purpose                                        |
| ------- | -------------------------------- | ---------------------------------------------- |
| `GET`   | `/projects/{projectId}/settings` | सक्रिय प्रोजेक्ट सेटिंग्स प्राप्त करें।        |
| `PATCH` | `/projects/{projectId}/settings` | preset लागू करें, settings पैच करें, या दोनों। |

पूर्ण request और response schemas **API reference** में हैं।

## वर्तमान सेटिंग्स प्राप्त करें

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

लागू किए गए किसी भी preset सहित, पूरी सक्रिय प्रोजेक्ट सेटिंग्स लौटाता है।

## सेटिंग्स पैच करें

`PATCH` `presetId` और `settings` के किसी भी subset को स्वीकार करता है। जब दोनों पास किए जाते हैं, तो पहले preset लागू होता है और फिर `settings` ऊपर से merge होती है।

<Tabs>
  <Tab title="Apply a preset">
    ```bash theme={null}
    curl -X PATCH https://api.youka.io/hi/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/hi/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/hi/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>

## मान्य फ़ील्ड्स खोजें

SDK वह schema export करता है जो project settings updates को validate करता है। इसे runtime पर JSON Schema में convert करें:

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

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

<Tip>
  Agents को project settings mutate करने से पहले SDK schema या OpenAPI request schema fetch करना चाहिए,
  ताकि उन्हें हमेशा वर्तमान shape पता रहे।
</Tip>

मानव-पठनीय संदर्भ:

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

## Project settings बनाम presets बनाम export overrides

Youka में तीन layers हैं जहाँ render settings रह सकते हैं:

| Layer                         | Scope           | कब उपयोग करें                                       |
| ----------------------------- | --------------- | --------------------------------------------------- |
| **Preset**                    | Account-wide    | कई projects में एक जैसा look।                       |
| **Project settings**          | One project     | प्रोजेक्ट-विशिष्ट trim, background, या color।       |
| **Export `settingsOverride`** | One export only | प्रोजेक्ट को छुए बिना किसी एक render को tweak करें। |

हर layer export समय पर इसी क्रम में merge होती है।

## आगे क्या

* [Render settings reference](/en/render-settings-reference) — सभी shared field paths और enum values
* [Presets](/hi/api/presets) — पुन: उपयोग योग्य configurations
* [Media](/hi/api/media) — settings से referenced
* [CLI projects](/hi/cli/projects) — terminal से वही flow
* [SDK project settings](/hi/sdk/project-settings) — TypeScript में वही endpoints