{
"error": {
"code": "not_found",
"message": "No preset with id 'preset_unknown'"
}
}
Presets
Get a preset
One preset plus tools: a ready-to-merge request fragment for each tool
it can be delivered into, keyed by tool name. Auth is optional; a Bearer
token also resolves the account’s private presets.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"varg","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/vargai/zXqiSRlI6Ucs30SP/logo/light.svg?fit=max\u0026auto=format\u0026n=zXqiSRlI6Ucs30SP\u0026q=85\u0026s=0cceec4fdf0144f327c9e64745254c58","dark":"https://mintcdn.com/vargai/zXqiSRlI6Ucs30SP/logo/dark.svg?fit=max\u0026auto=format\u0026n=zXqiSRlI6Ucs30SP\u0026q=85\u0026s=4e6978fc37965c951f846ee3fefc382b"},"favicon":"https://mintcdn.com/vargai/zXqiSRlI6Ucs30SP/favicon.svg?fit=max\u0026auto=format\u0026n=zXqiSRlI6Ucs30SP\u0026q=85\u0026s=8e374ac9e94bd40c3f7f07507a704dd8","navbar":{"links":[{"href":"https://app.varg.ai","label":"Dashboard"}],"primary":{"type":"button","label":"Get API Key","href":"https://app.varg.ai"}},"footer":{"socials":{"x":"https://x.com/vaborsh","github":"https://github.com/vargHQ"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/vargHQ/sdk"},{"anchor":"Discord","icon":"discord","href":"https://discord.gg/VAecJay7R9"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vargai","hasAudioNarration":false,"actualSubdomain":"vargai","customDomains":["docs.varg.ai"],"gitSource":{"type":"github","owner":"varghq","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true},"entitlements":{},"buildId":"6ad7966a0b9b371cf43481a1","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":90},{"language":"default","tag":"Documentation","count":44},{"language":"default","tag":"Models","count":27},{"language":"default","tag":"Files","count":17},{"language":"default","tag":"Templates","count":14},{"language":"default","tag":"Account","count":11},{"language":"default","tag":"Jobs","count":10},{"language":"default","tag":"Image","count":9},{"language":"default","tag":"Generation","count":9},{"language":"default","tag":"Video","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/presets/get-a-preset","slug":"/api-reference/presets/get-a-preset","pageMetadata":{"title":"Get a preset","description":"One preset plus `tools`: a ready-to-merge request fragment for each tool\nit can be delivered into, keyed by tool name. Auth is optional; a Bearer\ntoken also resolves the account's private presets.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /presets/{id}","href":"/api-reference/presets/get-a-preset","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"One preset plus \", _jsx(_components.code, {\n children: \"tools\"\n }), \": a ready-to-merge request fragment for each tool\\nit can be delivered into, keyed by tool name. Auth is optional; a Bearer\\ntoken also resolves the account’s private presets.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get a preset","description":"One preset plus `tools`: a ready-to-merge request fragment for each tool\nit can be delivered into, keyed by tool name. Auth is optional; a Bearer\ntoken also resolves the account's private presets.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /presets/{id}","href":"/api-reference/presets/get-a-preset","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Presets"],"operationId":"getPreset","summary":"Get a preset","description":"One preset plus `tools`: a ready-to-merge request fragment for each tool\nit can be delivered into, keyed by tool name. Auth is optional; a Bearer\ntoken also resolves the account's private presets.\n","security":["9054c6cc-8524-43c4-b665-1bb3711d6d1d","b87b1f8c-a664-4faa-950e-e06af5acb648"],"parameters":["dd9a8527-11ae-4162-b00b-48247a65d095"],"responses":{"200":"38c0e9b4-ee79-4cb2-b5df-83d7c965c270","404":"32465415-119b-4393-8a7a-d701bfb7e186"},"method":"get","type":"path","servers":["6415ef2b-ead3-41a4-9bec-7b332113d6a8"],"path":"/presets/{id}","baseUrlOptions":["https://api.varg.ai/v2"],"title":"Get a preset","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"dd9a8527-11ae-4162-b00b-48247a65d095":{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"preset_5f4dcc3b5aa7","isRequired":true,"description":"Preset id (`preset_\u003c12hex>`).","uniqueKey":"","typeLabel":"string"},"description":"Preset id (`preset_\u003c12hex>`)."}},"responses":{"38c0e9b4-ee79-4cb2-b5df-83d7c965c270":{"description":"The preset","content":{"application/json":{"schema":{"type":"object","required":["tools","id","kind","type","namespace","name","description","preview_url","metadata","status"],"properties":{"id":{"type":"string","description":"Canonical preset reference (`preset_\u003c12hex>`).","example":"preset_5f4dcc3b5aa7","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"kind":{"type":"string","description":"Preset layer. Currently always `provider_value`.","example":"provider_value","isRequired":true,"uniqueKey":"kind","typeLabel":"string"},"type":{"type":"string","description":"Which parameter the preset fills (for example `voice`, `style`).","example":"voice","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"namespace":{"type":"string","description":"Whose id system minted the value (for example `elevenlabs`, `higgsfield`, `fal`).","example":"elevenlabs","isRequired":true,"uniqueKey":"namespace","typeLabel":"string"},"name":{"type":"string","example":"Brian","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"description":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"description","typeLabel":"string | null"},"preview_url":{"oneOf":[{"type":"string","description":"Sample audio or image for the preset.","isRequired":true,"uniqueKey":"preview_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Sample audio or image for the preset.","isRequired":true,"uniqueKey":"preview_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"preview_url","typeLabel":"string | null"},"metadata":{"type":"object","additionalProperties":true,"description":"Filterable attributes. Keys vary by type; values are strings or arrays of strings.","isRequired":true,"uniqueKey":"metadata","typeLabel":"object"},"status":{"type":"string","enum":["active","deprecated"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"tools":{"type":"object","description":"Ready-to-merge request fragment per tool, keyed by tool name. A\nfragment with a broken mapping is returned as `{ \"_error\": \"\u003cmessage>\" }`.\n","additionalProperties":{"type":"object","additionalProperties":true,"uniqueKey":"tools.additionalProperties","typeLabel":"object"},"example":{"speech":{"voice":"preset_5f4dcc3b5aa7"}},"isRequired":true,"uniqueKey":"tools","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"voice":{"title":"voice","value":{"id":"preset_5f4dcc3b5aa7","kind":"provider_value","type":"voice","namespace":"elevenlabs","name":"Brian","description":"Deep, professional male voice","preview_url":"https://s3.varg.ai/presets/voice/brian.mp3","metadata":{"gender":"male","tone":["deep"]},"status":"active","tools":{"speech":{"voice":"preset_5f4dcc3b5aa7"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"32465415-119b-4393-8a7a-d701bfb7e186":{"description":"Unknown preset","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"model_not_found","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"Unknown model: flux-shnell","uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"notFound":{"title":"notFound","value":{"error":{"code":"not_found","message":"No preset with id 'preset_unknown'"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"9054c6cc-8524-43c4-b665-1bb3711d6d1d":{},"b87b1f8c-a664-4faa-950e-e06af5acb648":{"bearerAuth":{"type":"http","scheme":"bearer","description":"varg API key (`varg_...`). Get one at [app.varg.ai](https://app.varg.ai)\nor run `bunx vargai login`. App sessions may alternatively send a\nSupabase JWT.\n","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"6415ef2b-ead3-41a4-9bec-7b332113d6a8":{"url":"https://api.varg.ai/v2"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"varg API key (`varg_...`). Get one at [app.varg.ai](https://app.varg.ai)\nor run `bunx vargai login`. App sessions may alternatively send a\nSupabase JWT.\n","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"varg API key (`varg_...`). Get one at [app.varg.ai](https://app.varg.ai)\nor run `bunx vargai login`. App sessions may alternatively send a\nSupabase JWT.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"vargai","siteName":"varg","title":"Get a preset - varg","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-20T16:27:17.442Z","originalFileLocation":"api-reference/presets/get-a-preset.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"One preset plus tools: a ready-to-merge request fragment for each tool it can be delivered into, keyed by tool name. Auth is optional; a Bearer token also resolves the account\u0026#x27;s private presets.\">\u003cmeta data-mint-head name=\"application-name\" content=\"varg\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vargai/LJMR_3vGQnsy6v-B/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/vargai/LJMR_3vGQnsy6v-B/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vargai/LJMR_3vGQnsy6v-B/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/vargai/LJMR_3vGQnsy6v-B/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/vargai/LJMR_3vGQnsy6v-B/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vargai/LJMR_3vGQnsy6v-B/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vargai/LJMR_3vGQnsy6v-B/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/vargai/LJMR_3vGQnsy6v-B/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/vargai/LJMR_3vGQnsy6v-B/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a preset - varg\">\u003cmeta data-mint-head property=\"og:description\" content=\"One preset plus tools: a ready-to-merge request fragment for each tool it can be delivered into, keyed by tool name. Auth is optional; a Bearer token also resolves the account\u0026#x27;s private presets.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"varg\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.varg.ai/api-reference/presets/get-a-preset\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vargai.mintlify.site/_mintlify/api/og/v2?division=Presets\u0026amp;title=Get+a+preset\u0026amp;description=One+preset+plus+%60tools%60%3A+a+ready-to-merge+request+fragment+for+each+tool%0Ait+can+be+delivered+into%2C+keyed+by+tool+name.+Auth+is+optional%3B+a+Bearer%0Atoken+also+res\u0026amp;theme=8e4322200b2c6ec3222c2f2d\u0026amp;signature=822281c1a6bed43723b720c6031f97813e0be6ac0369faa0bc1b822b3012b313\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get a preset - varg\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"One preset plus tools: a ready-to-merge request fragment for each tool it can be delivered into, keyed by tool name. Auth is optional; a Bearer token also resolves the account\u0026#x27;s private presets.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vargai.mintlify.site/_mintlify/api/og/v2?division=Presets\u0026amp;title=Get+a+preset\u0026amp;description=One+preset+plus+%60tools%60%3A+a+ready-to-merge+request+fragment+for+each+tool%0Ait+can+be+delivered+into%2C+keyed+by+tool+name.+Auth+is+optional%3B+a+Bearer%0Atoken+also+res\u0026amp;theme=8e4322200b2c6ec3222c2f2d\u0026amp;signature=822281c1a6bed43723b720c6031f97813e0be6ac0369faa0bc1b822b3012b313\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/vargai/LJMR_3vGQnsy6v-B/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"varg\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.varg.ai/api-reference/presets/get-a-preset\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/presets/get-a-preset.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.varg.ai/#organization\",\"name\":\"varg\",\"url\":\"https://docs.varg.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vargai/zXqiSRlI6Ucs30SP/logo/light.svg?fit=max\u0026auto=format\u0026n=zXqiSRlI6Ucs30SP\u0026q=85\u0026s=0cceec4fdf0144f327c9e64745254c58\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.varg.ai#website\",\"name\":\"varg\",\"url\":\"https://docs.varg.ai\",\"publisher\":{\"@id\":\"https://docs.varg.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.varg.ai/api-reference/presets/get-a-preset#webpage\",\"url\":\"https://docs.varg.ai/api-reference/presets/get-a-preset\",\"name\":\"Get a preset\",\"description\":\"One preset plus tools: a ready-to-merge request fragment for each tool it can be delivered into, keyed by tool name. Auth is optional; a Bearer token also resolves the account's private presets.\",\"dateModified\":\"2026-10-20T16:27:17.442Z\",\"isPartOf\":{\"@id\":\"https://docs.varg.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.varg.ai/api-reference/presets/get-a-preset#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.varg.ai/api-reference/presets/get-a-preset#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Presets\",\"item\":\"https://docs.varg.ai/api/presets\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a preset\",\"item\":\"https://docs.varg.ai/api-reference/presets/get-a-preset\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.varg.ai/api-reference/presets/get-a-preset#apireference\",\"headline\":\"Get a preset\",\"name\":\"Get a preset\",\"description\":\"One preset plus tools: a ready-to-merge request fragment for each tool it can be delivered into, keyed by tool name. Auth is optional; a Bearer token also resolves the account's private presets.\",\"url\":\"https://docs.varg.ai/api-reference/presets/get-a-preset\",\"mainEntityOfPage\":{\"@id\":\"https://docs.varg.ai/api-reference/presets/get-a-preset#webpage\"},\"dateModified\":\"2026-10-20T16:27:17.442Z\",\"publisher\":{\"@id\":\"https://docs.varg.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.varg.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"varg\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"varg","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/vargHQ/sdk"},{"anchor":"Discord","icon":"discord","href":"https://discord.gg/VAecJay7R9"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"varg API","href":"/api"},{"title":"OpenAPI spec","href":"/api/openapi"},{"title":"Folders","href":"/api/folders"},{"title":"Render API","href":"/render-api/index"}]},{"group":"Presets","pages":[{"title":"Presets","href":"/api/presets"},{"title":"List presets","deprecated":null,"version":null,"openapi":"/openapi.yaml get /presets","href":"/api-reference/presets/list-presets"},{"title":"Get preset filter axes","description":"The metadata filter vocabulary, derived from stored presets. Returns a\nmap of axis name to `{ value: count }`, where the count is the number of\npresets that `?\u003caxis>=\u003cvalue>` on `GET /presets` would return. Scope with\n`type`, since voices and styles have different axes. Auth is optional.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /presets/filters","href":"/api-reference/presets/get-preset-filter-axes"},{"title":"Get a preset","deprecated":null,"version":null,"openapi":"/openapi.yaml get /presets/{id}","href":"/api-reference/presets/get-a-preset"},{"title":"Apply presets to a request body","description":"Merges one or more presets into a request body you intend to send to a\ngeneration endpoint and returns the finished payload. The tool is inferred\nfrom `payload.model`. Presets that cannot be applied (unknown, no mapping\nfor the model's tool, or dropped by the model's schema) are reported in\n`rejected` instead of failing the call. Returns `200` when at least one\npreset applied and `422` when none did; the `422` body then still has the\n`payload`/`applied`/`rejected` shape. A `422` with an `error` envelope means\nthe model in `payload.model` is unknown. Auth is optional.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /presets/apply","href":"/api-reference/presets/apply-presets-to-a-request-body"},{"title":"Recommend presets for an intent","deprecated":null,"version":null,"openapi":"/openapi.yaml post /presets/recommend","href":"/api-reference/presets/recommend-presets-for-an-intent"}]},{"group":"Generation","pages":[{"title":"Generate an image","deprecated":null,"version":null,"openapi":"/openapi.yaml post /image","href":"/api-reference/generation/generate-an-image"},{"title":"Generate a video","deprecated":null,"version":null,"openapi":"/openapi.yaml post /video","href":"/api-reference/generation/generate-a-video"},{"title":"Analyze a video","deprecated":null,"version":null,"openapi":"/openapi.yaml post /video/analyze","href":"/api-reference/generation/analyze-a-video"},{"title":"Generate speech (TTS)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /speech","href":"/api-reference/generation/generate-speech-tts"},{"title":"Generate music","deprecated":null,"version":null,"openapi":"/openapi.yaml post /music","href":"/api-reference/generation/generate-music"},{"title":"Transcribe audio","deprecated":null,"version":null,"openapi":"/openapi.yaml post /transcription","href":"/api-reference/generation/transcribe-audio"},{"title":"Run an ffmpeg operation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /ffmpeg","href":"/api-reference/generation/run-an-ffmpeg-operation"},{"title":"Render TSX to video","deprecated":null,"version":null,"openapi":"/openapi.yaml post /render","href":"/api-reference/generation/render-tsx-to-video"},{"title":"Run a custom pipeline","deprecated":null,"version":null,"openapi":"/openapi.yaml post /pipeline","href":"/api-reference/generation/run-a-custom-pipeline"}]},{"group":"Tools","pages":[{"title":"List tools","deprecated":null,"version":null,"openapi":"/openapi.yaml get /tools","href":"/api-reference/tools/list-tools"},{"title":"Get tool metadata","deprecated":null,"version":null,"openapi":"/openapi.yaml get /tools/{tool_key}","href":"/api-reference/tools/get-tool-metadata"},{"title":"Call a tool generically","deprecated":null,"version":null,"openapi":"/openapi.yaml post /tools/{tool_key}/call","href":"/api-reference/tools/call-a-tool-generically"},{"title":"List a tool's models","deprecated":null,"version":null,"openapi":"/openapi.yaml get /tools/{tool_key}/models","href":"/api-reference/tools/list-a-tools-models"},{"title":"List models","deprecated":null,"version":null,"openapi":"/openapi.yaml get /models","href":"/api-reference/tools/list-models"}]},{"group":"Jobs","pages":[{"title":"List jobs","deprecated":null,"version":null,"openapi":"/openapi.yaml get /jobs","href":"/api-reference/jobs/list-jobs"},{"title":"Get a job","deprecated":null,"version":null,"openapi":"/openapi.yaml get /jobs/{id}","href":"/api-reference/jobs/get-a-job"},{"title":"Get job status (lightweight)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /jobs/{id}/status","href":"/api-reference/jobs/get-job-status-lightweight"},{"title":"Get job pricing breakdown","deprecated":null,"version":null,"openapi":"/openapi.yaml get /jobs/{id}/price","href":"/api-reference/jobs/get-job-pricing-breakdown"},{"title":"Refresh a job","deprecated":null,"version":null,"openapi":"/openapi.yaml post /jobs/{id}/refresh","href":"/api-reference/jobs/refresh-a-job"},{"title":"Cancel a job","deprecated":null,"version":null,"openapi":"/openapi.yaml post /jobs/{id}/cancel","href":"/api-reference/jobs/cancel-a-job"},{"title":"Retry a failed job","deprecated":null,"version":null,"openapi":"/openapi.yaml post /jobs/{id}/retry","href":"/api-reference/jobs/retry-a-failed-job"},{"title":"Get what a job and its run were charged","deprecated":null,"version":null,"openapi":"/openapi.yaml get /jobs/{id}/cost","href":"/api-reference/jobs/get-what-a-job-and-its-run-were-charged"},{"title":"Approve, retry or reject a paused job","deprecated":null,"version":null,"openapi":"/openapi.yaml post /jobs/{id}/confirm","href":"/api-reference/jobs/approve-retry-or-reject-a-paused-job"},{"title":"Re-run a finished pipeline job from a later step","deprecated":null,"version":null,"openapi":"/openapi.yaml post /jobs/{id}/rerun","href":"/api-reference/jobs/re-run-a-finished-pipeline-job-from-a-later-step"}]},{"group":"Files","pages":[{"title":"Upload a file","deprecated":null,"version":null,"openapi":"/openapi.yaml post /files","href":"/api-reference/files/upload-a-file"},{"title":"List files","deprecated":null,"version":null,"openapi":"/openapi.yaml get /files","href":"/api-reference/files/list-files"},{"title":"Import a file by URL","deprecated":null,"version":null,"openapi":"/openapi.yaml post /files/import","href":"/api-reference/files/import-a-file-by-url"},{"title":"Probe a URL's media metadata","deprecated":null,"version":null,"openapi":"/openapi.yaml post /files/probe","href":"/api-reference/files/probe-a-urls-media-metadata"},{"title":"Check for an existing file by hash","deprecated":null,"version":null,"openapi":"/openapi.yaml get /files/check","href":"/api-reference/files/check-for-an-existing-file-by-hash"},{"title":"Get file metadata","deprecated":null,"version":null,"openapi":"/openapi.yaml get /files/{id}","href":"/api-reference/files/get-file-metadata"},{"title":"Delete a file","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /files/{id}","href":"/api-reference/files/delete-a-file"},{"title":"Rate or comment on a file","deprecated":null,"version":null,"openapi":"/openapi.yaml post /files/{id}/feedback","href":"/api-reference/files/rate-or-comment-on-a-file"},{"title":"List feedback for a file","deprecated":null,"version":null,"openapi":"/openapi.yaml get /files/{id}/feedback","href":"/api-reference/files/list-feedback-for-a-file"},{"title":"Remove your rating on a file","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /files/{id}/feedback","href":"/api-reference/files/remove-your-rating-on-a-file"},{"title":"Start a large file upload","deprecated":null,"version":null,"openapi":"/openapi.yaml post /files/upload-session","href":"/api-reference/files/start-a-large-file-upload"},{"title":"Upload bytes to an upload session","deprecated":null,"version":null,"openapi":"/openapi.yaml put /files/upload/{session_id}","href":"/api-reference/files/upload-bytes-to-an-upload-session"},{"title":"List files with lineage","deprecated":null,"version":null,"openapi":"/openapi.yaml get /resources/files","href":"/api-reference/files/list-files-with-lineage"},{"title":"Get a file with lineage","deprecated":null,"version":null,"openapi":"/openapi.yaml get /resources/files/{id}","href":"/api-reference/files/get-a-file-with-lineage"},{"title":"Rename a file","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /resources/files/{id}","href":"/api-reference/files/rename-a-file"},{"title":"Favorite or unfavorite a file","deprecated":null,"version":null,"openapi":"/openapi.yaml post /resources/files/{id}/favorite","href":"/api-reference/files/favorite-or-unfavorite-a-file"},{"title":"Resolve a file to the job that created it","deprecated":null,"version":null,"openapi":"/openapi.yaml post /lineage","href":"/api-reference/lineage/resolve-a-file-to-the-job-that-created-it"}]},{"group":"Folders","pages":[{"title":"List folders","deprecated":null,"version":null,"openapi":"/openapi.yaml get /workspaces","href":"/api-reference/folders/list-folders"},{"title":"Create a folder","deprecated":null,"version":null,"openapi":"/openapi.yaml post /workspaces","href":"/api-reference/folders/create-a-folder"},{"title":"Get a folder","deprecated":null,"version":null,"openapi":"/openapi.yaml get /workspaces/{id}","href":"/api-reference/folders/get-a-folder"},{"title":"Rename a folder or change its slug","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /workspaces/{id}","href":"/api-reference/folders/rename-a-folder-or-change-its-slug"},{"title":"List files in a folder","deprecated":null,"version":null,"openapi":"/openapi.yaml get /workspaces/{id}/files","href":"/api-reference/folders/list-files-in-a-folder"},{"title":"Add files to a folder","deprecated":null,"version":null,"openapi":"/openapi.yaml post /workspaces/{id}/files","href":"/api-reference/folders/add-files-to-a-folder"},{"title":"Remove a file from a folder","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /workspaces/{id}/files/{file_id}","href":"/api-reference/folders/remove-a-file-from-a-folder"}]},{"group":"Templates","pages":[{"title":"Browse and search templates","deprecated":null,"version":null,"openapi":"/openapi.yaml get /templates","href":"/api-reference/templates/browse-and-search-templates"},{"title":"List template tags","deprecated":null,"version":null,"openapi":"/openapi.yaml get /templates/tags","href":"/api-reference/templates/list-template-tags"},{"title":"Get a template","deprecated":null,"version":null,"openapi":"/openapi.yaml get /templates/{id}","href":"/api-reference/templates/get-a-template"},{"title":"Increment the use counter","deprecated":null,"version":null,"openapi":"/openapi.yaml post /templates/{id}/use","href":"/api-reference/templates/increment-the-use-counter"},{"title":"Render a template to video","deprecated":null,"version":null,"openapi":"/openapi.yaml post /templates/{id}/render","href":"/api-reference/templates/render-a-template-to-video"},{"title":"Publish a document as a template","deprecated":null,"version":null,"openapi":"/openapi.yaml post /templates","href":"/api-reference/templates/publish-a-document-as-a-template"},{"title":"Withdraw a template","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /templates/{id}","href":"/api-reference/templates/withdraw-a-template"},{"title":"List your templates","deprecated":null,"version":null,"openapi":"/openapi.yaml get /templates/my","href":"/api-reference/templates/list-your-templates"},{"title":"List your favorite templates","deprecated":null,"version":null,"openapi":"/openapi.yaml get /templates/favorites","href":"/api-reference/templates/list-your-favorite-templates"},{"title":"Toggle favorite","deprecated":null,"version":null,"openapi":"/openapi.yaml post /templates/{id}/favorite","href":"/api-reference/templates/toggle-favorite"}]},{"group":"Pricing \u0026 Billing","pages":[{"title":"Estimate a price without creating a job","deprecated":null,"version":null,"openapi":"/openapi.yaml post /estimate","href":"/api-reference/pricing/estimate-a-price-without-creating-a-job"},{"title":"Get the price catalog (public)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /pricing","href":"/api-reference/pricing/get-the-price-catalog-public"},{"title":"Get balance","deprecated":null,"version":null,"openapi":"/openapi.yaml get /billing/balance","href":"/api-reference/billing/get-balance"},{"title":"Get usage records","deprecated":null,"version":null,"openapi":"/openapi.yaml get /billing/usage","href":"/api-reference/billing/get-usage-records"},{"title":"Get transaction ledger","deprecated":null,"version":null,"openapi":"/openapi.yaml get /billing/transactions","href":"/api-reference/billing/get-transaction-ledger"}]},{"group":"Analytics","pages":[{"title":"Spend summary","deprecated":null,"version":null,"openapi":"/openapi.yaml get /analytics/summary","href":"/api-reference/analytics/spend-summary"},{"title":"Spend over time","deprecated":null,"version":null,"openapi":"/openapi.yaml get /analytics/timeseries","href":"/api-reference/analytics/spend-over-time"},{"title":"Spend breakdown","deprecated":null,"version":null,"openapi":"/openapi.yaml get /analytics/breakdown","href":"/api-reference/analytics/spend-breakdown"},{"title":"List charges or runs","deprecated":null,"version":null,"openapi":"/openapi.yaml get /analytics/activity","href":"/api-reference/analytics/list-charges-or-runs"},{"title":"Files generated over time","deprecated":null,"version":null,"openapi":"/openapi.yaml get /analytics/files","href":"/api-reference/analytics/files-generated-over-time"},{"title":"Analytics definitions","deprecated":null,"version":null,"openapi":"/openapi.yaml get /analytics/meta","href":"/api-reference/analytics/analytics-definitions"}]},{"group":"Account","pages":[{"title":"Get the authenticated account","deprecated":null,"version":null,"openapi":"/openapi.yaml get /me","href":"/api-reference/account/get-the-authenticated-account"},{"title":"List API keys","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api-keys","href":"/api-reference/account/list-api-keys"},{"title":"Create an API key","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api-keys","href":"/api-reference/account/create-an-api-key"},{"title":"Rename an API key","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /api-keys/{id}","href":"/api-reference/account/rename-an-api-key"},{"title":"Revoke an API key","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /api-keys/{id}","href":"/api-reference/account/revoke-an-api-key"},{"title":"Reveal an API key","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api-keys/{id}/reveal","href":"/api-reference/account/reveal-an-api-key"},{"title":"List who an API key is shared with","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api-keys/{id}/shares","href":"/api-reference/account/list-who-an-api-key-is-shared-with"},{"title":"Share an API key","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api-keys/{id}/shares","href":"/api-reference/account/share-an-api-key"},{"title":"Remove someone from an API key","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /api-keys/{id}/shares/{userId}","href":"/api-reference/account/remove-someone-from-an-api-key"},{"title":"Get a connection's team binding","deprecated":null,"version":null,"openapi":"/openapi.yaml get /me/connection","href":"/api-reference/account/get-a-connections-team-binding"},{"title":"Set a connection's team binding","deprecated":null,"version":null,"openapi":"/openapi.yaml put /me/connection","href":"/api-reference/account/set-a-connections-team-binding"}]}]}]},"basePath":"","title":"Get a preset - varg","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}