हर प्रोजेक्ट में सक्रिय सेटिंग्स होती हैं — trim, background, subtitle style, layout — जो यह नियंत्रित करती हैं कि exports कैसे render होते हैं। जब आपको ऐसे project-local overrides चाहिए हों जिन्हें preset के रूप में साझा करना सार्थक न हो, तब project settings का उपयोग करें।
शेयर्ड preset, settings.style, और settingsOverride फ़ील्ड मैप के लिए Render settings reference देखें।
Endpoints
| Method | Path | Purpose |
|---|
GET | /projects/{projectId}/settings | सक्रिय प्रोजेक्ट सेटिंग्स प्राप्त करें। |
PATCH | /projects/{projectId}/settings | preset लागू करें, settings पैच करें, या दोनों। |
वर्तमान सेटिंग्स प्राप्त करें
curl https://api.youka.io/hi/api/v1/projects/prj_abc/settings \
-H "Authorization: Bearer yk_..."
सेटिंग्स पैच करें
PATCH presetId और settings के किसी भी subset को स्वीकार करता है। जब दोनों पास किए जाते हैं, तो पहले preset लागू होता है और फिर settings ऊपर से merge होती है।
Apply a preset
Inline settings
Preset + overrides
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"
}'
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"
}
}
}
}'
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 }
}
}'
मान्य फ़ील्ड्स खोजें
SDK वह schema export करता है जो project settings updates को validate करता है। इसे runtime पर JSON Schema में convert करें:
import { RestUpdateProjectSettingsRequestSchema } from "@youka/sdk";
const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();
Agents को project settings mutate करने से पहले SDK schema या OpenAPI request schema fetch करना चाहिए,
ताकि उन्हें हमेशा वर्तमान shape पता रहे।
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 करें। |
आगे क्या
