Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins)
Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins)
Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins). High stakes: Replaces the org-wide serving provider preference for every open-weight model served by more than one provider; the previous setting is not stored anywhere. Interactive clients should confirm with the user first. Runs as the token’s owner within their role; the portal’s own authorization and audit log apply.
POST
/
v1
/
admin
/
update_provider_preference
Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins)
A management token: minted by the OAuth flow (aireserve login, or an MCP client's Authenticate step) or on the portal Keys page under Management Keys. Inference API keys are refused.
Pin a provider: always serve from this slug where it offers the model (the balance decides elsewhere). Omit to keep the org's current pin, null to clear it.
Present exactly when secret is: redact this response from logs.
Available options:
true
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"AI Reserve Developer Documentation","colors":{"primary":"#8a7a50","light":"#c8c0a8","dark":"#b0a890"},"logo":{"light":"https://mintcdn.com/ai-reserve/kVGnXF7MyJRszayb/logo/light.svg?fit=max\u0026auto=format\u0026n=kVGnXF7MyJRszayb\u0026q=85\u0026s=4305e52131e25c047cb3dcee7304ebe1","dark":"https://mintcdn.com/ai-reserve/kVGnXF7MyJRszayb/logo/dark.svg?fit=max\u0026auto=format\u0026n=kVGnXF7MyJRszayb\u0026q=85\u0026s=8d7ceae367a63973571659fbe14964e7","href":"https://docs.aireserve.com"},"favicon":"https://mintcdn.com/ai-reserve/kVGnXF7MyJRszayb/favicon.svg?fit=max\u0026auto=format\u0026n=kVGnXF7MyJRszayb\u0026q=85\u0026s=a25b27a5ffce06736ec9f529f4150ca3","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript"]}},"appearance":{"default":"dark"},"background":{"decoration":"grid","color":{"light":"#faf8f1","dark":"#07172a"}},"navbar":{"links":[{"href":"https://portal.aireserve.com","label":"Portal"}],"primary":{"type":"button","label":"Get an API key","href":"https://portal.aireserve.com/keys"}},"footer":{"links":[{"header":"Developers","items":[{"label":"Get an API key","href":"https://portal.aireserve.com/keys"},{"label":"Portal","href":"https://portal.aireserve.com"},{"label":"Connect wizard","href":"https://portal.aireserve.com/connect"}]},{"header":"Trust \u0026 disclosures","items":[{"label":"Provider Data Handling","href":"https://privacy.aireserve.com/data-handling"},{"label":"Subprocessors","href":"https://privacy.aireserve.com/subprocessors"}]},{"header":"For AI agents","items":[{"label":"llms.txt","href":"https://docs.aireserve.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.aireserve.com/llms-full.txt"}]}]},"fonts":{"family":"Sora"},"icons":{"library":"lucide"},"styling":{"codeblocks":"dark","latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ai-reserve","hasAudioNarration":false,"actualSubdomain":"ai-reserve","customDomains":["docs.aireserve.com"],"gitSource":{"type":"github","owner":"audacity-investments","repo":"audacity","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae13cd75d82eb0117f89791","collectionId":"dc0b8211-96f8-4ab9-be0d-679cca4ff31a","liveDeploymentHistoryId":"6ae13cd75d82eb0117f89791","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae13cd75d82eb0117f89791","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"Models","count":279},{"language":"default","tag":"By maker","count":272},{"language":"default","tag":"API Reference","count":253},{"language":"default","tag":"Endpoints","count":247},{"language":"default","tag":"Documentation","count":78},{"language":"default","tag":"GPU Infrastructure","count":67},{"language":"default","tag":"Anthropic","count":40},{"language":"default","tag":"OpenAI","count":38},{"language":"default","tag":"DeepSeek","count":35},{"language":"default","tag":"Connect your tool","count":25}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYpHtKgS4.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYrXtKgS4.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYpntKgS4.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYp3tKgS4.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYqXtK.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYpHtKgS4.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYrXtKgS4.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYpntKgS4.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYp3tKgS4.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYqXtK.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYpHtKgS4.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYrXtKgS4.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYpntKgS4.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYp3tKgS4.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Cormorant Garamond';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/cormorantgaramond/v21/co3bmX5slCNuHLi8bLeY9MK7whWMhyjYqXtK.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmmono/v16/aFTU7PB1QTsUX8KYthSQBLyM.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmmono/v16/aFTU7PB1QTsUX8KYthqQBA.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmmono/v16/aFTR7PB1QTsUX8KYvumzEY2tbZX9.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmmono/v16/aFTR7PB1QTsUX8KYvumzEYOtbQ.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--ar-navy:#07172a;--ar-navy-deep:#050f1d;--ar-card:#0c1e33;--ar-raised:#122840;--ar-ivory:#f2ede3;--ar-gold:#b0a890;--ar-gold-lt:#c8c0a8;--ar-gold-rule:rgba(176, 168, 144, 0.28);--ar-border:rgba(120, 144, 155, 0.22);--ar-mono:\"DM Mono\", \"SF Mono\", ui-monospace, Menlo, Consolas, \"Liberation Mono\",\n monospace}code,kbd,pre,pre *,samp{font-family:var(--ar-mono)!important}#content-area h2,#page-title{font-family:\"Cormorant Garamond\",\"Iowan Old Style\",\"Palatino Linotype\",Palatino,Georgia,serif;font-weight:500;letter-spacing:.005em}#page-title{font-size:2.75rem;line-height:1.12}#content-area h2{font-size:1.85rem}#sidebar h5,#sidebar h6,sidebar-group-header{font-family:var(--ar-mono);font-size:.6875rem;font-weight:500;letter-spacing:.14em;text-transform:uppercase}.dark #sidebar h5,.dark #sidebar h6,.dark sidebar-group-header{color:#78909b}.dark #navbar{border-bottom:1px solid var(--ar-gold-rule)}.dark card{background:rgba(12,30,51,.55);border-color:var(--ar-border)}.dark card:hover{border-color:rgba(120,144,155,.38)}.dark .callout[data-callout-type=note]{background:rgba(176,168,144,.07);border-color:rgba(176,168,144,.26)}.dark .callout[data-callout-type=note] [data-component-part=callout-content],.dark .callout[data-callout-type=note] [data-component-part=callout-icon] svg{color:#d9d2bf}.callout[data-callout-type=note]{background:rgba(138,122,80,.07);border-color:rgba(138,122,80,.3)}.callout[data-callout-type=note] [data-component-part=callout-content],.callout[data-callout-type=note] [data-component-part=callout-icon] svg{color:#6b5f3e}"}],"page":{"pagePath":"api-reference/admin:-models-\u0026-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins","slug":"/api-reference/admin:-models-\u0026-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins","pageMetadata":{"title":"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins)","description":"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins). High stakes: Replaces the org-wide serving provider preference for every open-weight model served by more than one provider; the previous setting is not stored anywhere. Interactive clients should confirm with the user first. Runs as the token's owner within their role; the portal's own authorization and audit log apply.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/update_provider_preference","href":"/api-reference/admin:-models-\u0026-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins). High stakes: Replaces the org-wide serving provider preference for every open-weight model served by more than one provider; the previous setting is not stored anywhere. Interactive clients should confirm with the user first. Runs as the token’s owner within their role; the portal’s own authorization and audit log apply.\"\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":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins)","description":"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins). High stakes: Replaces the org-wide serving provider preference for every open-weight model served by more than one provider; the previous setting is not stored anywhere. Interactive clients should confirm with the user first. Runs as the token's owner within their role; the portal's own authorization and audit log apply.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/update_provider_preference","href":"/api-reference/admin:-models-\u0026-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Admin: Models \u0026 Routing"],"operationId":"update_provider_preference","summary":"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins)","description":"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins). High stakes: Replaces the org-wide serving provider preference for every open-weight model served by more than one provider; the previous setting is not stored anywhere. Interactive clients should confirm with the user first. Runs as the token's owner within their role; the portal's own authorization and audit log apply.","x-aireserve-domain":"models-routing","x-aireserve-kind":"write","x-aireserve-always-confirm":true,"x-aireserve-secret-returning":false,"requestBody":"dac51007-adf2-4ab9-a4a6-f90b1303b497","responses":{"200":"26e71801-cdc6-4295-aab3-a36d7d34a276","400":"20c05171-882b-4f9b-bc30-4c4094f810a5","401":"7141310b-61fb-4fba-96af-3c1b0dcd4f82","403":"9b149021-bace-4988-994a-1467036947a8","404":"caef81bb-e19b-43e4-879d-bafa745cd177","409":"61b3a5a8-d3d2-41e4-8a3f-c7269ed33b85","422":"78df8d7e-5ac2-4efd-9d9f-c411ce4326a2","429":"fea8ddc1-dbdf-4ccf-bcf7-067118da3d84"},"security":["b81efc74-caec-4134-99b5-adb1244064b0"],"method":"post","type":"path","servers":["2471c681-d8cb-4f37-b0ec-d26ffdb90871"],"path":"/v1/admin/update_provider_preference","baseUrlOptions":["https://api.aireserve.com"],"title":"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins)","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"preset":{"type":"string","enum":["cheapest","fastest","most_reliable","balanced","custom","split"],"description":"Named preset, custom with explicit weights, or split with providerShares","isRequired":true,"uniqueKey":"preset","typeLabel":"enum\u003cstring>"},"clientId":{"description":"Target organization id — platform admins only; omit otherwise","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"clientId","typeLabel":"string\u003cuuid>"},"weights":{"description":"Required for preset custom; ignored for named presets (their table weights apply)","type":"object","properties":{"price":{"type":"integer","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"weights.price","typeLabel":"integer"},"latency":{"type":"integer","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"weights.latency","typeLabel":"integer"},"reliability":{"type":"integer","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"weights.reliability","typeLabel":"integer"}},"required":["price","latency","reliability"],"uniqueKey":"weights","typeLabel":"object"},"excludedProviders":{"default":[],"description":"Serving-provider slugs never to serve this org (deepinfra, baseten, together, novita)","maxItems":12,"type":"array","items":{"type":"string","uniqueKey":"excludedProviders.items.[INDEX]","typeLabel":"string"},"uniqueKey":"excludedProviders","typeLabel":"string[]"},"keepConversationOnProvider":{"default":true,"description":"Keep a conversation on one provider (recommended); false re-decides every request","type":"boolean","uniqueKey":"keepConversationOnProvider","typeLabel":"boolean"},"pinnedProvider":{"oneOf":[{"description":"Pin a provider: always serve from this slug where it offers the model (the balance decides elsewhere). Omit to keep the org's current pin, null to clear it.","type":"string","uniqueKey":"pinnedProvider.oneOf.0","typeLabel":"string"},{"description":"Pin a provider: always serve from this slug where it offers the model (the balance decides elsewhere). Omit to keep the org's current pin, null to clear it.","type":"null","uniqueKey":"pinnedProvider.oneOf.1","typeLabel":"null"}],"uniqueKey":"pinnedProvider","typeLabel":"string | null"},"providerShares":{"description":"Split traffic (preset split only): fixed shares per provider slug summing to 100, e.g. {\"deepinfra\": 60, \"baseten\": 40} (deepinfra, baseten, together, novita)","type":"object","additionalProperties":{"type":"integer","minimum":1,"maximum":100,"uniqueKey":"providerShares.additionalProperties","typeLabel":"integer"},"uniqueKey":"providerShares","typeLabel":"object"}},"required":["preset"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"clientId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","excludedProviders":[],"keepConversationOnProvider":true,"pinnedProvider":"\u003cstring>","providerShares":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"26e71801-cdc6-4295-aab3-a36d7d34a276":{"description":"Executed successfully (`ok: true`).","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["executed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"ok":{"type":"boolean","description":"Whether the operation succeeded.","isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"summary":{"type":"string","description":"The consent line describing what was done, built from resolved labels.","isRequired":true,"uniqueKey":"summary","typeLabel":"string"},"message":{"type":"string","description":"Human-readable result line.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"description":"Operation payload (reads) or detail worth relaying (writes).","uniqueKey":"data","typeLabel":"any"},"secret":{"description":"A one-time secret the operation minted (API key, credential). Shown once; store it now.","type":"string","uniqueKey":"secret","typeLabel":"string"},"sensitive":{"description":"Present exactly when `secret` is: redact this response from logs.","type":"boolean","enum":[true],"uniqueKey":"sensitive","typeLabel":"enum\u003cboolean>"}},"required":["status","ok","summary","message"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"executed","ok":true,"summary":"\u003cstring>","message":"\u003cstring>","data":"\u003cunknown>","secret":"\u003cstring>","sensitive":true}}},"exampleType":"generated"}},"exampleType":"generated"},"20c05171-882b-4f9b-bc30-4c4094f810a5":{"description":"Invalid input for this operation, or a confirm token problem.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["refused"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["unknown_op","not_allowed","insufficient_scope","invalid_input","confirm_invalid","confirm_expired","target_changed"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["status","code","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"refused","code":"unknown_op","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"7141310b-61fb-4fba-96af-3c1b0dcd4f82":{"description":"Missing, expired or revoked management token. Inference API keys are refused.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"error_description":{"type":"string","isRequired":true,"uniqueKey":"error_description","typeLabel":"string"}},"required":["error","error_description"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","error_description":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"9b149021-bace-4988-994a-1467036947a8":{"description":"The operation is not available at the caller's access level.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["refused"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["unknown_op","not_allowed","insufficient_scope","invalid_input","confirm_invalid","confirm_expired","target_changed"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["status","code","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"refused","code":"unknown_op","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"caef81bb-e19b-43e4-879d-bafa745cd177":{"description":"Unknown operation id.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["refused"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["unknown_op","not_allowed","insufficient_scope","invalid_input","confirm_invalid","confirm_expired","target_changed"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["status","code","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"refused","code":"unknown_op","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"61b3a5a8-d3d2-41e4-8a3f-c7269ed33b85":{"description":"The target changed since it was described (`target_changed`).","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["refused"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["unknown_op","not_allowed","insufficient_scope","invalid_input","confirm_invalid","confirm_expired","target_changed"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["status","code","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"refused","code":"unknown_op","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"78df8d7e-5ac2-4efd-9d9f-c411ce4326a2":{"description":"Executed but the operation reported a failure (`ok: false`, see `message`).","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["executed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"ok":{"type":"boolean","description":"Whether the operation succeeded.","isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"summary":{"type":"string","description":"The consent line describing what was done, built from resolved labels.","isRequired":true,"uniqueKey":"summary","typeLabel":"string"},"message":{"type":"string","description":"Human-readable result line.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"description":"Operation payload (reads) or detail worth relaying (writes).","uniqueKey":"data","typeLabel":"any"},"secret":{"description":"A one-time secret the operation minted (API key, credential). Shown once; store it now.","type":"string","uniqueKey":"secret","typeLabel":"string"},"sensitive":{"description":"Present exactly when `secret` is: redact this response from logs.","type":"boolean","enum":[true],"uniqueKey":"sensitive","typeLabel":"enum\u003cboolean>"}},"required":["status","ok","summary","message"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"executed","ok":true,"summary":"\u003cstring>","message":"\u003cstring>","data":"\u003cunknown>","secret":"\u003cstring>","sensitive":true}}},"exampleType":"generated"}},"exampleType":"generated"},"fea8ddc1-dbdf-4ccf-bcf7-067118da3d84":{"description":"Organization request budget exhausted; see `Retry-After`.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"error_description":{"type":"string","isRequired":true,"uniqueKey":"error_description","typeLabel":"string"}},"required":["error","error_description"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","error_description":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"b81efc74-caec-4134-99b5-adb1244064b0":{"managementToken":{"type":"http","scheme":"bearer","bearerFormat":"aireserve_mcp_…","description":"A management token: minted by the OAuth flow (`aireserve login`, or an MCP client's Authenticate step) or on the portal Keys page under Management Keys. Inference API keys are refused.","scopes":[],"schemeName":"managementToken"}}},"servers":{"2471c681-d8cb-4f37-b0ec-d26ffdb90871":{"url":"https://api.aireserve.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"aireserve_mcp_…","description":"A management token: minted by the OAuth flow (`aireserve login`, or an MCP client's Authenticate step) or on the portal Keys page under Management Keys. Inference API keys are refused.","scopes":[],"schemeName":"managementToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A management token: minted by the OAuth flow (`aireserve login`, or an MCP client's Authenticate step) or on the portal Keys page under Management Keys. Inference API keys are refused.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"managementToken","name":"Authorization"}],"title":"managementToken"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"ai-reserve","siteName":"AI Reserve Developer Documentation","title":"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins) - AI Reserve Developer Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T00:08:05.088Z","originalFileLocation":"api-reference/admin:-models-\u0026-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins.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=\"dark\"}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=\"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins). High stakes: Replaces the org-wide serving provider preference for every open-weight model served by more than one provider; the previous setting is not stored anywhere. Interactive clients should confirm with the user first. Runs as the token\u0026#x27;s owner within their role; the portal\u0026#x27;s own authorization and audit log apply.\">\u003cmeta data-mint-head name=\"application-name\" content=\"AI Reserve Developer Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ai-reserve/6c4vKdK5wwkhGrb_/_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/ai-reserve/6c4vKdK5wwkhGrb_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ai-reserve/6c4vKdK5wwkhGrb_/_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/ai-reserve/6c4vKdK5wwkhGrb_/_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/ai-reserve/6c4vKdK5wwkhGrb_/_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/ai-reserve/6c4vKdK5wwkhGrb_/_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/ai-reserve/6c4vKdK5wwkhGrb_/_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/ai-reserve/6c4vKdK5wwkhGrb_/_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/ai-reserve/6c4vKdK5wwkhGrb_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins) - AI Reserve Developer Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins). High stakes: Replaces the org-wide serving provider preference for every open-weight model served by more than one provider; the previous setting is not stored anywhere. Interactive clients should confirm with the user first. Runs as the token\u0026#x27;s owner within their role; the portal\u0026#x27;s own authorization and audit log apply.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AI Reserve Developer Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.aireserve.com/api-reference/admin:-models-\u0026amp;-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ai-reserve.mintlify.app/_mintlify/api/og/v2?division=Admin%3A+Models+%26+Routing\u0026amp;title=Choose+which+provider+serves+open-weight+models+several+providers+host%3A+a+preset+or+custom+price%2Flatency%2Freliability+balance%2C+fixed+traffic+shares%2C+a+pinned+provider%2C+exclusions%2C+and+stickiness+%28admins%29\u0026amp;description=Choose+which+provider+serves+open-weight+models+several+providers+host%3A+a+preset+or+custom+price%2Flatency%2Freliability+balance%2C+fixed+traffic+shares%2C+a+pinned+pro\u0026amp;theme=9ad3102375139745a61bf236\u0026amp;signature=9d4c05cbb2c9e30cd5b010db74ea5fe625764b4ca54fe74e5b54d3fd7e09c21e\">\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=\"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins) - AI Reserve Developer Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins). High stakes: Replaces the org-wide serving provider preference for every open-weight model served by more than one provider; the previous setting is not stored anywhere. Interactive clients should confirm with the user first. Runs as the token\u0026#x27;s owner within their role; the portal\u0026#x27;s own authorization and audit log apply.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ai-reserve.mintlify.app/_mintlify/api/og/v2?division=Admin%3A+Models+%26+Routing\u0026amp;title=Choose+which+provider+serves+open-weight+models+several+providers+host%3A+a+preset+or+custom+price%2Flatency%2Freliability+balance%2C+fixed+traffic+shares%2C+a+pinned+provider%2C+exclusions%2C+and+stickiness+%28admins%29\u0026amp;description=Choose+which+provider+serves+open-weight+models+several+providers+host%3A+a+preset+or+custom+price%2Flatency%2Freliability+balance%2C+fixed+traffic+shares%2C+a+pinned+pro\u0026amp;theme=9ad3102375139745a61bf236\u0026amp;signature=9d4c05cbb2c9e30cd5b010db74ea5fe625764b4ca54fe74e5b54d3fd7e09c21e\">\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/ai-reserve/6c4vKdK5wwkhGrb_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AI Reserve Developer Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8a7a50\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.aireserve.com/api-reference/admin:-models-\u0026amp;-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/admin%3A-models-%26-routing/choose-which-provider-serves-open-weight-models-several-providers-host%3A-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.aireserve.com/#organization\",\"name\":\"AI Reserve Developer Documentation\",\"url\":\"https://docs.aireserve.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ai-reserve/kVGnXF7MyJRszayb/logo/light.svg?fit=max\u0026auto=format\u0026n=kVGnXF7MyJRszayb\u0026q=85\u0026s=4305e52131e25c047cb3dcee7304ebe1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.aireserve.com#website\",\"name\":\"AI Reserve Developer Documentation\",\"url\":\"https://docs.aireserve.com\",\"publisher\":{\"@id\":\"https://docs.aireserve.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.aireserve.com/api-reference/admin:-models-\u0026-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins#webpage\",\"url\":\"https://docs.aireserve.com/api-reference/admin:-models-\u0026-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins\",\"name\":\"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins)\",\"description\":\"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins). High stakes: Replaces the org-wide serving provider preference for every open-weight model served by more than one provider; the previous setting is not stored anywhere. Interactive clients should confirm with the user first. Runs as the token's owner within their role; the portal's own authorization and audit log apply.\",\"dateModified\":\"2026-10-28T00:08:05.088Z\",\"isPartOf\":{\"@id\":\"https://docs.aireserve.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.aireserve.com/api-reference/admin:-models-\u0026-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.aireserve.com/api-reference/admin:-models-\u0026-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.aireserve.com/api-reference/models/list-models\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Admin: Models \u0026 Routing\",\"item\":\"https://docs.aireserve.com/api-reference/admin:-models-\u0026-routing/remove-the-orgs-bring-your-own-router-endpoint-admins\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins)\",\"item\":\"https://docs.aireserve.com/api-reference/admin:-models-\u0026-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.aireserve.com/api-reference/admin:-models-\u0026-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins#apireference\",\"headline\":\"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins)\",\"name\":\"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins)\",\"description\":\"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins). High stakes: Replaces the org-wide serving provider preference for every open-weight model served by more than one provider; the previous setting is not stored anywhere. Interactive clients should confirm with the user first. Runs as the token's owner within their role; the portal's own authorization and audit log apply.\",\"url\":\"https://docs.aireserve.com/api-reference/admin:-models-\u0026-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins\",\"mainEntityOfPage\":{\"@id\":\"https://docs.aireserve.com/api-reference/admin:-models-\u0026-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins#webpage\"},\"dateModified\":\"2026-10-28T00:08:05.088Z\",\"publisher\":{\"@id\":\"https://docs.aireserve.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.aireserve.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AI Reserve Developer Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"AI Reserve Developer Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/getting-started/for-your-team"}]},{"tab":"Models","pages":[{"title":"Models","href":"/models"}]},{"tab":"API Reference","groups":[{"group":"Reference","pages":[{"title":"Wire protocol","icon":"network","href":"/api-reference"},{"title":"OpenAI \u0026 Anthropic formats — native in the AI Reserve SDKs","sidebarTitle":"SDK wire formats","icon":"file-json","href":"/api-reference/sdk-wire-formats"},{"title":"Errors \u0026 retries","icon":"triangle-alert","href":"/api-reference/errors"},{"title":"Configuration","icon":"settings-2","href":"/api-reference/configuration"},{"title":"Customer keys","icon":"key-round","href":"/api-reference/customer-keys"},{"title":"Versioning \u0026 support","icon":"life-buoy","href":"/api-reference/versioning-and-support"}]},{"group":"Endpoints","pages":[{"group":"Models","pages":[{"title":"List models","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/models","href":"/api-reference/models/list-models"}]},{"group":"Videos","pages":[{"title":"Submit video generation job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/videos/generations","href":"/api-reference/videos/submit-video-generation-job"},{"title":"Get video generation job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/videos/generations/{job_id}","href":"/api-reference/videos/get-video-generation-job"}]},{"group":"Embeddings","pages":[{"title":"Create embeddings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/embeddings","href":"/api-reference/embeddings/create-embeddings"}]},{"group":"Search","pages":[{"title":"Live data and web search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/search","href":"/api-reference/search/live-data-and-web-search"}]},{"group":"Bedrock","pages":[{"title":"Converse (Bedrock wire format)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /model/{modelId}/converse","href":"/api-reference/bedrock/converse-bedrock-wire-format"},{"title":"Converse stream (Bedrock wire format)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /model/{modelId}/converse-stream","href":"/api-reference/bedrock/converse-stream-bedrock-wire-format"}]},{"group":"Audio","pages":[{"title":"List custom voices","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/custom-voices","href":"/api-reference/audio/list-custom-voices"},{"title":"Create custom voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/custom-voices","href":"/api-reference/audio/create-custom-voice"},{"title":"Get custom voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/custom-voices/{voice_id}","href":"/api-reference/audio/get-custom-voice"},{"title":"Delete custom voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/custom-voices/{voice_id}","href":"/api-reference/audio/delete-custom-voice"},{"title":"Update custom voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/custom-voices/{voice_id}","href":"/api-reference/audio/update-custom-voice"},{"title":"Synthesize speech","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/audio/speech","href":"/api-reference/audio/synthesize-speech"},{"title":"Transcribe audio","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/audio/transcriptions","href":"/api-reference/audio/transcribe-audio"},{"title":"List built-in voices","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/voices","href":"/api-reference/audio/list-built-in-voices"}]},{"group":"Chat","pages":[{"title":"Create chat completion","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/chat/completions","href":"/api-reference/chat/create-chat-completion"}]},{"group":"Responses","pages":[{"title":"Create response (Responses API)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/responses","href":"/api-reference/responses/create-response-responses-api"}]},{"group":"Data endpoints","pages":[{"title":"Discover data endpoints","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/monid/discover","href":"/api-reference/data-endpoints/discover-data-endpoints"},{"title":"Inspect data endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/monid/inspect","href":"/api-reference/data-endpoints/inspect-data-endpoint"},{"title":"Run data endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/monid/run","href":"/api-reference/data-endpoints/run-data-endpoint"},{"title":"Get data endpoint run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/monid/runs/{run_id}","href":"/api-reference/data-endpoints/get-data-endpoint-run"}]},{"group":"Realtime","pages":[{"title":"Mint realtime voice session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/realtime/sessions","href":"/api-reference/realtime/mint-realtime-voice-session"}]},{"group":"Files","pages":[{"title":"Create file upload slot","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/files","href":"/api-reference/files/create-file-upload-slot"},{"title":"Get file upload status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/files/{file_id}","href":"/api-reference/files/get-file-upload-status"}]},{"group":"Messages","pages":[{"title":"Create message","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/messages","href":"/api-reference/messages/create-message"},{"title":"Count tokens","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/messages/count_tokens","href":"/api-reference/messages/count-tokens"}]},{"group":"Images","pages":[{"title":"Generate images","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/images/generations","href":"/api-reference/images/generate-images"}]},{"group":"Decisions","pages":[{"title":"Typed decision (yes/no, choice, score)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/decisions","href":"/api-reference/decisions/typed-decision-yesno-choice-score"}]},{"group":"Customers","pages":[{"title":"Usage and billable amounts per end customer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/customers/usage","href":"/api-reference/customers/usage-and-billable-amounts-per-end-customer"},{"title":"Usage for one end customer, by feature or day","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/customers/{customerId}/usage","href":"/api-reference/customers/usage-for-one-end-customer-by-feature-or-day"}]},{"group":"GPU Infrastructure","pages":[{"title":"List GPU types","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/catalog","href":"/api-reference/gpu-infrastructure/list-gpu-types"},{"title":"List GPU types","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/catalog/gpus","href":"/api-reference/gpu-infrastructure/list-gpu-types-1"},{"title":"List data centers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/catalog/datacenters","href":"/api-reference/gpu-infrastructure/list-data-centers"},{"title":"Request a price quote","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/quotes","href":"/api-reference/gpu-infrastructure/request-a-price-quote"},{"title":"List GPU instances","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/instances","href":"/api-reference/gpu-infrastructure/list-gpu-instances"},{"title":"Launch GPU instance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/instances","href":"/api-reference/gpu-infrastructure/launch-gpu-instance"},{"title":"Quote GPU instance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/instances/quote","href":"/api-reference/gpu-infrastructure/quote-gpu-instance"},{"title":"Get GPU instance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/instances/{instanceId}","href":"/api-reference/gpu-infrastructure/get-gpu-instance"},{"title":"Terminate GPU instance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/gpu/instances/{instanceId}","href":"/api-reference/gpu-infrastructure/terminate-gpu-instance"},{"title":"Start GPU instance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/instances/{instanceId}/start","href":"/api-reference/gpu-infrastructure/start-gpu-instance"},{"title":"Stop GPU instance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/instances/{instanceId}/stop","href":"/api-reference/gpu-infrastructure/stop-gpu-instance"},{"title":"Set GPU instance recovery policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/gpu/instances/{instanceId}/recovery","href":"/api-reference/gpu-infrastructure/set-gpu-instance-recovery-policy"},{"title":"Recover GPU instance now","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/instances/{instanceId}/recover","href":"/api-reference/gpu-infrastructure/recover-gpu-instance-now"},{"title":"Get GPU instance connections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/instances/{instanceId}/connections","href":"/api-reference/gpu-infrastructure/get-gpu-instance-connections"},{"title":"Stream GPU instance logs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/instances/{instanceId}/logs","href":"/api-reference/gpu-infrastructure/stream-gpu-instance-logs"},{"title":"List GPU clusters","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/clusters","href":"/api-reference/gpu-infrastructure/list-gpu-clusters"},{"title":"Launch GPU cluster","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/clusters","href":"/api-reference/gpu-infrastructure/launch-gpu-cluster"},{"title":"Quote GPU cluster","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/clusters/quote","href":"/api-reference/gpu-infrastructure/quote-gpu-cluster"},{"title":"Get GPU cluster","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/clusters/{clusterId}","href":"/api-reference/gpu-infrastructure/get-gpu-cluster"},{"title":"Terminate GPU cluster","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/gpu/clusters/{clusterId}","href":"/api-reference/gpu-infrastructure/terminate-gpu-cluster"},{"title":"Set GPU cluster recovery policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/gpu/clusters/{clusterId}/recovery","href":"/api-reference/gpu-infrastructure/set-gpu-cluster-recovery-policy"},{"title":"Recover GPU cluster now","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/clusters/{clusterId}/recover","href":"/api-reference/gpu-infrastructure/recover-gpu-cluster-now"},{"title":"Get GPU cluster connections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/clusters/{clusterId}/connections","href":"/api-reference/gpu-infrastructure/get-gpu-cluster-connections"},{"title":"Stream GPU cluster node logs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/clusters/{clusterId}/logs","href":"/api-reference/gpu-infrastructure/stream-gpu-cluster-node-logs"},{"title":"List pods","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/pods","href":"/api-reference/gpu-infrastructure/list-pods"},{"title":"Create pod (legacy)","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/pods","href":"/api-reference/gpu-infrastructure/create-pod-legacy"},{"title":"Get pod","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/pods/{podId}","href":"/api-reference/gpu-infrastructure/get-pod"},{"title":"Terminate pod","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/gpu/pods/{podId}","href":"/api-reference/gpu-infrastructure/terminate-pod"},{"title":"Start pod","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/pods/{podId}/start","href":"/api-reference/gpu-infrastructure/start-pod"},{"title":"Stop pod","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/pods/{podId}/stop","href":"/api-reference/gpu-infrastructure/stop-pod"},{"title":"Get pod connections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/pods/{podId}/connections","href":"/api-reference/gpu-infrastructure/get-pod-connections"},{"title":"Stream pod logs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/pods/{podId}/logs","href":"/api-reference/gpu-infrastructure/stream-pod-logs"},{"title":"List volumes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/volumes","href":"/api-reference/gpu-infrastructure/list-volumes"},{"title":"Create volume","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/volumes","href":"/api-reference/gpu-infrastructure/create-volume"},{"title":"Get volume","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/volumes/{volumeId}","href":"/api-reference/gpu-infrastructure/get-volume"},{"title":"Delete volume","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/gpu/volumes/{volumeId}","href":"/api-reference/gpu-infrastructure/delete-volume"},{"title":"Grow volume","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/gpu/volumes/{volumeId}","href":"/api-reference/gpu-infrastructure/grow-volume"},{"title":"List templates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/templates","href":"/api-reference/gpu-infrastructure/list-templates"},{"title":"Create template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/templates","href":"/api-reference/gpu-infrastructure/create-template"},{"title":"Get template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/templates/{templateId}","href":"/api-reference/gpu-infrastructure/get-template"},{"title":"Update template (deprecated alias)","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json put /v1/gpu/templates/{templateId}","href":"/api-reference/gpu-infrastructure/update-template-deprecated-alias"},{"title":"Delete template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/gpu/templates/{templateId}","href":"/api-reference/gpu-infrastructure/delete-template"},{"title":"Update template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/gpu/templates/{templateId}","href":"/api-reference/gpu-infrastructure/update-template"},{"title":"List registry credentials","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/registries","href":"/api-reference/gpu-infrastructure/list-registry-credentials"},{"title":"Add registry credential","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/registries","href":"/api-reference/gpu-infrastructure/add-registry-credential"},{"title":"Delete registry credential","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/gpu/registries/{registryId}","href":"/api-reference/gpu-infrastructure/delete-registry-credential"},{"title":"Rotate registry credential","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/gpu/registries/{registryId}","href":"/api-reference/gpu-infrastructure/rotate-registry-credential"},{"title":"List SSH keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/ssh-keys","href":"/api-reference/gpu-infrastructure/list-ssh-keys"},{"title":"Add SSH key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/gpu/ssh-keys","href":"/api-reference/gpu-infrastructure/add-ssh-key"},{"title":"Revoke SSH key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/gpu/ssh-keys/{keyId}","href":"/api-reference/gpu-infrastructure/revoke-ssh-key"},{"title":"Get operation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/operations/{operationId}","href":"/api-reference/gpu-infrastructure/get-operation"},{"title":"List usage and charges","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/usage","href":"/api-reference/gpu-infrastructure/list-usage-and-charges"},{"title":"List GPU offers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/gpu/offers","href":"/api-reference/gpu-infrastructure/list-gpu-offers"}]},{"group":"Customer keys","pages":[{"title":"List a customer's keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/customers/{customerId}/keys","href":"/api-reference/customer-keys/list-a-customers-keys"},{"title":"Create a customer key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/customers/{customerId}/keys","href":"/api-reference/customer-keys/create-a-customer-key"},{"title":"Revoke a customer key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/customers/{customerId}/keys/{keyId}","href":"/api-reference/customer-keys/revoke-a-customer-key"}]},{"group":"Extractions","pages":[{"title":"Typed extraction (text, number, date, list, estimate, forecast)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/extractions","href":"/api-reference/extractions/typed-extraction-text-number-date-list-estimate-forecast"}]},{"group":"AWS CLI login","pages":[{"title":"Initiate OAuth authorization (PKCE)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/authorize","href":"/api-reference/aws-cli-login/initiate-oauth-authorization-pkce"},{"title":"Cross-device authorization relay","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sessions/confirmation","href":"/api-reference/aws-cli-login/cross-device-authorization-relay"},{"title":"Exchange or refresh AWS credentials","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/token","href":"/api-reference/aws-cli-login/exchange-or-refresh-aws-credentials"}]},{"group":"Fine-tuning","pages":[{"title":"List base models","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/training/bases","href":"/api-reference/fine-tuning/list-base-models"},{"title":"List datasets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/training/datasets","href":"/api-reference/fine-tuning/list-datasets"},{"title":"Create a dataset folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/training/datasets","href":"/api-reference/fine-tuning/create-a-dataset-folder"},{"title":"Get a dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/training/datasets/{datasetId}","href":"/api-reference/fine-tuning/get-a-dataset"},{"title":"Presign an upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/training/datasets/{datasetId}/upload","href":"/api-reference/fine-tuning/presign-an-upload"},{"title":"Mint an upload session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/training/datasets/{datasetId}/session","href":"/api-reference/fine-tuning/mint-an-upload-session"},{"title":"Validate a dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/training/datasets/{datasetId}/validate","href":"/api-reference/fine-tuning/validate-a-dataset"},{"title":"Quote a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/training/jobs/quote","href":"/api-reference/fine-tuning/quote-a-run"},{"title":"List runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/training/jobs","href":"/api-reference/fine-tuning/list-runs"},{"title":"Start a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/training/jobs","href":"/api-reference/fine-tuning/start-a-run"},{"title":"Get a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/training/jobs/{jobId}","href":"/api-reference/fine-tuning/get-a-run"},{"title":"Cancel a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/training/jobs/{jobId}/cancel","href":"/api-reference/fine-tuning/cancel-a-run"},{"title":"List models","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/training/models","href":"/api-reference/fine-tuning/list-models"},{"title":"Get a model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/training/models/{modelId}","href":"/api-reference/fine-tuning/get-a-model"},{"title":"Download links","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/training/models/{modelId}/download","href":"/api-reference/fine-tuning/download-links"},{"title":"List deployments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/training/deployments","href":"/api-reference/fine-tuning/list-deployments"},{"title":"Deploy a model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/training/deployments","href":"/api-reference/fine-tuning/deploy-a-model"},{"title":"Get a deployment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/training/deployments/{deploymentId}","href":"/api-reference/fine-tuning/get-a-deployment"},{"title":"Stop a deployment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/training/deployments/{deploymentId}","href":"/api-reference/fine-tuning/stop-a-deployment"}]},{"group":"Admin: Catalog","pages":[{"title":"The operations this token may call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/admin/ops","href":"/api-reference/admin:-catalog/the-operations-this-token-may-call"}]},{"group":"Admin: Analytics","pages":[{"title":"Compact analytics summary for a custom date range or an org/team/member scope (get-usage-summary already covers quick preset views)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_analytics_dashboard","href":"/api-reference/admin:-analytics/compact-analytics-summary-for-a-custom-date-range-or-an-orgteammember-scope-get-usage-summary-already-covers-quick-preset-views"},{"title":"Usage grouped by business function and team (classification rollup), top 25 rows by cost","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_business_function_usage","href":"/api-reference/admin:-analytics/usage-grouped-by-business-function-and-team-classification-rollup-top-25-rows-by-cost"},{"title":"Legal filter values (models, providers, statuses; users and clients for platform admins) for the gateway stats/log ops","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_gateway_filter_options","href":"/api-reference/admin:-analytics/legal-filter-values-models-providers-statuses;-users-and-clients-for-platform-admins-for-the-gateway-statslog-ops"},{"title":"One page of gateway request-log rows (metadata only, max 20) — who called which model, when, cost, status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_gateway_request_log","href":"/api-reference/admin:-analytics/one-page-of-gateway-request-log-rows-metadata-only-max-20-—-who-called-which-model-when-cost-status"},{"title":"Aggregate gateway totals (requests, tokens, spend, latency, errors) filtered by date/model/provider/status/user","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_gateway_usage_stats","href":"/api-reference/admin:-analytics/aggregate-gateway-totals-requests-tokens-spend-latency-errors-filtered-by-datemodelproviderstatususer"},{"title":"Trailing-365-day model usage rollup (top 5 models by spend) for an org, team subtree, or member set","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_model_usage_year","href":"/api-reference/admin:-analytics/trailing-365-day-model-usage-rollup-top-5-models-by-spend-for-an-org-team-subtree-or-member-set"},{"title":"30-day USD spend split (input / output / cached) for the organization","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_spend_breakdown","href":"/api-reference/admin:-analytics/30-day-usd-spend-split-input-output-cached-for-the-organization"}]},{"group":"Admin: API Keys","pages":[{"title":"Check whether a Copilot connect key has received traffic beyond its own self-test (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/check_copilot_key_traffic","href":"/api-reference/admin:-api-keys/check-whether-a-copilot-connect-key-has-received-traffic-beyond-its-own-self-test-admins"},{"title":"Create an organization API key, optionally bound to a member (the secret is shown once, in the card)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/create_client_api_key","href":"/api-reference/admin:-api-keys/create-an-organization-api-key-optionally-bound-to-a-member-the-secret-is-shown-once-in-the-card"},{"title":"Create a team-scoped API key (the secret is shown once, in the card)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/create_team_api_key","href":"/api-reference/admin:-api-keys/create-a-team-scoped-api-key-the-secret-is-shown-once-in-the-card"},{"title":"30-day request count and last-use time per organization API key — idle-key detection (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_client_api_key_trends","href":"/api-reference/admin:-api-keys/30-day-request-count-and-last-use-time-per-organization-api-key-—-idle-key-detection-admins"},{"title":"Per-key request/token/cost totals for the organization, optional date range (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_client_api_key_usage","href":"/api-reference/admin:-api-keys/per-key-requesttokencost-totals-for-the-organization-optional-date-range-admins"},{"title":"List the organization's API keys — ids, masked key, scope, status, last use (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_client_api_keys","href":"/api-reference/admin:-api-keys/list-the-organizations-api-keys-—-ids-masked-key-scope-status-last-use-admins"},{"title":"Revoke any of the organization's API keys (irreversible; admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/revoke_client_api_key","href":"/api-reference/admin:-api-keys/revoke-any-of-the-organizations-api-keys-irreversible;-admins"},{"title":"Turn always-on context compaction on or off for an organization API key (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_api_key_compaction","href":"/api-reference/admin:-api-keys/turn-always-on-context-compaction-on-or-off-for-an-organization-api-key-admins"},{"title":"Send a one-token test ping through an API key — verifies auth, model policy, caps, and the provider (a real metered call)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/test_api_key","href":"/api-reference/admin:-api-keys/send-a-one-token-test-ping-through-an-api-key-—-verifies-auth-model-policy-caps-and-the-provider-a-real-metered-call"}]},{"group":"Admin: Billing","pages":[{"title":"Close a usage period and anchor it into the immutable hash chain, ahead of CARR generation (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/close_ledger_period","href":"/api-reference/admin:-billing/close-a-usage-period-and-anchor-it-into-the-immutable-hash-chain-ahead-of-carr-generation-admins"},{"title":"Generate CARR summary figures for a period — totals and top models only; schedule detail and file exports stay on /admin/carr (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/generate_carr_report","href":"/api-reference/admin:-billing/generate-carr-summary-figures-for-a-period-—-totals-and-top-models-only;-schedule-detail-and-file-exports-stay-on-admincarr-admins"},{"title":"Ledger rollup — opening/closing balance, additions, all-time consumption — from the mirrored wallet events, or the live wallet when nothing has been synced (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_ledger_balance","href":"/api-reference/admin:-billing/ledger-rollup-—-openingclosing-balance-additions-all-time-consumption-—-from-the-mirrored-wallet-events-or-the-live-wallet-when-nothing-has-been-synced-admins"},{"title":"Current wallet balance and last-epoch yield from yield-to-compute (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_wallet_summary","href":"/api-reference/admin:-billing/current-wallet-balance-and-last-epoch-yield-from-yield-to-compute-admins"},{"title":"Closed-and-hashed ledger periods with their record counts and hashes (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_ledger_periods","href":"/api-reference/admin:-billing/closed-and-hashed-ledger-periods-with-their-record-counts-and-hashes-admins"},{"title":"Credits into the organization's wallet — funding, sweeps, transfers in; not consumption (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_wallet_credits","href":"/api-reference/admin:-billing/credits-into-the-organizations-wallet-—-funding-sweeps-transfers-in;-not-consumption-admins"}]},{"group":"Admin: Compute","pages":[{"title":"Delete a persistent GPU volume and its data (must be detached; irreversible)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/delete_gpu_volume","href":"/api-reference/admin:-compute/delete-a-persistent-gpu-volume-and-its-data-must-be-detached;-irreversible"},{"title":"One GPU machine in detail: state, image, ports, volume, and how to connect (SSH command, exposed URLs)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_gpu_machine","href":"/api-reference/admin:-compute/one-gpu-machine-in-detail:-state-image-ports-volume-and-how-to-connect-ssh-command-exposed-urls"},{"title":"The last ~200 lines of a GPU machine's container output","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_gpu_machine_logs","href":"/api-reference/admin:-compute/the-last-~200-lines-of-a-gpu-machines-container-output"},{"title":"Launch a GPU machine — from a quoteId, or from a request plus a maxHourlyPrice ceiling; bills the organization's wallet hourly from now","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/launch_gpu_instance","href":"/api-reference/admin:-compute/launch-a-gpu-machine-—-from-a-quoteid-or-from-a-request-plus-a-maxhourlyprice-ceiling;-bills-the-organizations-wallet-hourly-from-now"},{"title":"The organization's GPU machines with state, GPU, hourly rate and attached volume","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_gpu_machines","href":"/api-reference/admin:-compute/the-organizations-gpu-machines-with-state-gpu-hourly-rate-and-attached-volume"},{"title":"GPU models available right now with per-GPU hourly price and stock level (provider-hidden; use the accelerator id to quote)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_gpu_offers","href":"/api-reference/admin:-compute/gpu-models-available-right-now-with-per-gpu-hourly-price-and-stock-level-provider-hidden;-use-the-accelerator-id-to-quote"},{"title":"The organization's persistent GPU volumes: size, region, hourly storage rate, state, which machine has it attached","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_gpu_volumes","href":"/api-reference/admin:-compute/the-organizations-persistent-gpu-volumes:-size-region-hourly-storage-rate-state-which-machine-has-it-attached"},{"title":"Price a GPU machine request all-in (GPU, root disk, optional persistent storage) and get a quoteId to launch exactly that; creates nothing","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/quote_gpu_instance","href":"/api-reference/admin:-compute/price-a-gpu-machine-request-all-in-gpu-root-disk-optional-persistent-storage-and-get-a-quoteid-to-launch-exactly-that;-creates-nothing"},{"title":"Start a stopped GPU machine (hourly billing resumes)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/start_gpu_machine","href":"/api-reference/admin:-compute/start-a-stopped-gpu-machine-hourly-billing-resumes"},{"title":"Stop a running GPU machine (GPU billing pauses; the root disk is lost, a persistent volume is kept; start_gpu_machine resumes)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/stop_gpu_machine","href":"/api-reference/admin:-compute/stop-a-running-gpu-machine-gpu-billing-pauses;-the-root-disk-is-lost-a-persistent-volume-is-kept;-start_gpu_machine-resumes"},{"title":"Terminate a GPU machine for good (root disk destroyed; an attached persistent volume survives and keeps billing until deleted)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/terminate_gpu_machine","href":"/api-reference/admin:-compute/terminate-a-gpu-machine-for-good-root-disk-destroyed;-an-attached-persistent-volume-survives-and-keeps-billing-until-deleted"}]},{"group":"Admin: Containers","pages":[{"title":"Create an empty ECS cluster","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/create_ecs_cluster","href":"/api-reference/admin:-containers/create-an-empty-ecs-cluster"},{"title":"Mint an ECS credential — an AWS access key pair for the AWS CLI and SDKs (the pair renders in the portal only, once)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/create_ecs_credential","href":"/api-reference/admin:-containers/mint-an-ecs-credential-—-an-aws-access-key-pair-for-the-aws-cli-and-sdks-the-pair-renders-in-the-portal-only-once"},{"title":"Delete an EMPTY cluster (no services, no tasks)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/delete_ecs_cluster","href":"/api-reference/admin:-containers/delete-an-empty-cluster-no-services-no-tasks"},{"title":"Delete a service — a deployed container loses its URL and load balancer; a classic service is force-deleted","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/delete_ecs_service","href":"/api-reference/admin:-containers/delete-a-service-—-a-deployed-container-loses-its-url-and-load-balancer;-a-classic-service-is-force-deleted"},{"title":"Schedule a secret for deletion with a 7–30 day recovery window (default 30); restore_secret cancels until then","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/delete_secret","href":"/api-reference/admin:-containers/schedule-a-secret-for-deletion-with-a-7–30-day-recovery-window-default-30;-restore_secret-cancels-until-then"},{"title":"Deploy a container image as a public HTTPS service (ECS Express Mode: AWS provisions the load balancer, TLS, autoscaling and a *.on.aws URL)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/deploy_container_service","href":"/api-reference/admin:-containers/deploy-a-container-image-as-a-public-https-service-ecs-express-mode:-aws-provisions-the-load-balancer-tls-autoscaling-and-a-*onaws-url"},{"title":"Enable the AWS Hub: create the organization's own AWS account behind the AWS passthrough (idempotent; takes a few minutes to become active)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/enable_containers","href":"/api-reference/admin:-containers/enable-the-aws-hub:-create-the-organizations-own-aws-account-behind-the-aws-passthrough-idempotent;-takes-a-few-minutes-to-become-active"},{"title":"The organization's AWS container account (enabled? lifecycle state, AWS account id) and its ECS credentials (names and key hints, never secrets)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_containers_account","href":"/api-reference/admin:-containers/the-organizations-aws-container-account-enabled?-lifecycle-state-aws-account-id-and-its-ecs-credentials-names-and-key-hints-never-secrets"},{"title":"How to put the AWS CLI on the organization's AWS account: the one `aireserve aws configure` command (recommended; native `aws login`, no static key), plus the static-credential gateway settings for CI, SDKs and Terraform","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_containers_connection_guide","href":"/api-reference/admin:-containers/how-to-put-the-aws-cli-on-the-organizations-aws-account:-the-one-`aireserve-aws-configure`-command-recommended;-native-`aws-login`-no-static-key-plus-the-static-credential-gateway-settings-for-ci-sdks-and-terraform"},{"title":"One cluster: its services (with deployments and recent events) and its tasks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_ecs_cluster","href":"/api-reference/admin:-containers/one-cluster:-its-services-with-deployments-and-recent-events-and-its-tasks"},{"title":"Read CloudWatch logs of a task or a whole service (log group from get_ecs_service / get_ecs_task; newest 200 events by default, optional text filter)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_ecs_logs","href":"/api-reference/admin:-containers/read-cloudwatch-logs-of-a-task-or-a-whole-service-log-group-from-get_ecs_service-get_ecs_task;-newest-200-events-by-default-optional-text-filter"},{"title":"One service: counts, deployments, events, tasks, and — for a deployed container — its HTTPS URL, image, size, scaling and log group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_ecs_service","href":"/api-reference/admin:-containers/one-service:-counts-deployments-events-tasks-and-—-for-a-deployed-container-—-its-https-url-image-size-scaling-and-log-group"},{"title":"One task: containers, health, exit codes, and the CloudWatch log streams to read with get_ecs_logs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_ecs_task","href":"/api-reference/admin:-containers/one-task:-containers-health-exit-codes-and-the-cloudwatch-log-streams-to-read-with-get_ecs_logs"},{"title":"One secret's metadata and versions (AWSCURRENT / AWSPREVIOUS) only — the value never flows through this connection; the portal shows the exact shell command to read it","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_secret","href":"/api-reference/admin:-containers/one-secrets-metadata-and-versions-awscurrent-awsprevious-only-—-the-value-never-flows-through-this-connection;-the-portal-shows-the-exact-shell-command-to-read-it"},{"title":"ECS clusters in a region with running/pending task and service counts, plus this month's Fargate usage","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_ecs_clusters","href":"/api-reference/admin:-containers/ecs-clusters-in-a-region-with-runningpending-task-and-service-counts-plus-this-months-fargate-usage"},{"title":"Task definition families in a region with their latest revision","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_ecs_task_definitions","href":"/api-reference/admin:-containers/task-definition-families-in-a-region-with-their-latest-revision"},{"title":"Secrets Manager secrets in a region: names, ARNs, descriptions, last changed, scheduled-deletion dates — never values","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_secrets","href":"/api-reference/admin:-containers/secrets-manager-secrets-in-a-region:-names-arns-descriptions-last-changed-scheduled-deletion-dates-—-never-values"},{"title":"Roll back: make an older version of a secret AWSCURRENT (version ids from get_secret)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/promote_secret_version","href":"/api-reference/admin:-containers/roll-back:-make-an-older-version-of-a-secret-awscurrent-version-ids-from-get_secret"},{"title":"Force a new deployment of a service (re-pulls the image, rolls tasks)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/redeploy_ecs_service","href":"/api-reference/admin:-containers/force-a-new-deployment-of-a-service-re-pulls-the-image-rolls-tasks"},{"title":"Cancel a scheduled deletion; the secret and all its versions come back unchanged","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/restore_secret","href":"/api-reference/admin:-containers/cancel-a-scheduled-deletion;-the-secret-and-all-its-versions-come-back-unchanged"},{"title":"Revoke an ECS credential (AWS CLIs and SDKs using it stop reaching the account)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/revoke_ecs_credential","href":"/api-reference/admin:-containers/revoke-an-ecs-credential-aws-clis-and-sdks-using-it-stop-reaching-the-account"},{"title":"Set a classic service's desired task count (0 pauses it)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/scale_ecs_service","href":"/api-reference/admin:-containers/set-a-classic-services-desired-task-count-0-pauses-it"},{"title":"Stop one running task (a service replaces it; a one-off task just ends)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/stop_ecs_task","href":"/api-reference/admin:-containers/stop-one-running-task-a-service-replaces-it;-a-one-off-task-just-ends"},{"title":"Change a deployed container service: new image (rolling deploy), size, environment, or scaling bounds","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/update_container_service","href":"/api-reference/admin:-containers/change-a-deployed-container-service:-new-image-rolling-deploy-size-environment-or-scaling-bounds"}]},{"group":"Admin: Files","pages":[{"title":"Delete a stored file from the organization (irreversible)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/delete_org_file","href":"/api-reference/admin:-files/delete-a-stored-file-from-the-organization-irreversible"},{"title":"Mint a one-hour download link for a stored file (shown in the card only)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_file_download_link","href":"/api-reference/admin:-files/mint-a-one-hour-download-link-for-a-stored-file-shown-in-the-card-only"},{"title":"List the organization's shared files (name, type, size, upload date)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_org_files","href":"/api-reference/admin:-files/list-the-organizations-shared-files-name-type-size-upload-date"}]},{"group":"Admin: Members","pages":[{"title":"Move a member onto a team, or to Unassigned (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/assign_member_team","href":"/api-reference/admin:-members/move-a-member-onto-a-team-or-to-unassigned-admins"},{"title":"One member's usage broken down by model (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_member_usage_by_model","href":"/api-reference/admin:-members/one-members-usage-broken-down-by-model-admins"},{"title":"Token and spend totals for up to 25 members by id (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_member_usage_totals","href":"/api-reference/admin:-members/token-and-spend-totals-for-up-to-25-members-by-id-admins"},{"title":"Usage from shared org/team API keys that no user is attributed to (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_shared_key_usage","href":"/api-reference/admin:-members/usage-from-shared-orgteam-api-keys-that-no-user-is-attributed-to-admins"},{"title":"Shared-key (unattributed) usage broken down by model (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_shared_key_usage_by_model","href":"/api-reference/admin:-members/shared-key-unattributed-usage-broken-down-by-model-admins"},{"title":"Invite a new user to the organization (admins and team leads)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/invite_user","href":"/api-reference/admin:-members/invite-a-new-user-to-the-organization-admins-and-team-leads"},{"title":"Search the org's user accounts, including inactive and soft-deleted ones the directory omits (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_org_users","href":"/api-reference/admin:-members/search-the-orgs-user-accounts-including-inactive-and-soft-deleted-ones-the-directory-omits-admins"},{"title":"Restore a soft-deleted member and re-send their onboarding email (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/restore_user","href":"/api-reference/admin:-members/restore-a-soft-deleted-member-and-re-send-their-onboarding-email-admins"},{"title":"Send or resend a member's onboarding email (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/send_onboarding_email","href":"/api-reference/admin:-members/send-or-resend-a-members-onboarding-email-admins"},{"title":"Email a member a password reset link (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/send_password_reset","href":"/api-reference/admin:-members/email-a-member-a-password-reset-link-admins"},{"title":"Activate or deactivate a member's account (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_member_active","href":"/api-reference/admin:-members/activate-or-deactivate-a-members-account-admins"},{"title":"Promote or demote a member between regular user and enterprise admin (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_user_org_role","href":"/api-reference/admin:-members/promote-or-demote-a-member-between-regular-user-and-enterprise-admin-admins"},{"title":"Edit a member's profile — name, phone, address, contact notes (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/update_member_profile","href":"/api-reference/admin:-members/edit-a-members-profile-—-name-phone-address-contact-notes-admins"}]},{"group":"Admin: Models \u0026 Routing","pages":[{"title":"Remove the org's bring-your-own router endpoint (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/clear_router_endpoint","href":"/api-reference/admin:-models-\u0026-routing/remove-the-orgs-bring-your-own-router-endpoint-admins"},{"title":"Live per-provider pricing and uptime for one catalog model (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_model_provider_endpoints","href":"/api-reference/admin:-models-\u0026-routing/live-per-provider-pricing-and-uptime-for-one-catalog-model-admins"},{"title":"Lock model selection and/or replace the org's blocked-model list or blocked-maker list (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_model_governance","href":"/api-reference/admin:-models-\u0026-routing/lock-model-selection-andor-replace-the-orgs-blocked-model-list-or-blocked-maker-list-admins"},{"title":"Set or clear an organization's default chat model (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_org_default_model","href":"/api-reference/admin:-models-\u0026-routing/set-or-clear-an-organizations-default-chat-model-admins"},{"title":"Test a bring-your-own router endpoint and save it if it passes (admins)","description":"Test a bring-your-own router endpoint and save it if it passes (admins). High stakes: Sends a live test request to this URL and, if it passes, routes every Auto-mode chat's model choice through it. Interactive clients should confirm with the user first. Runs as the token's owner within their role; the portal's own authorization and audit log apply.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_router_endpoint","href":"/api-reference/admin:-models-\u0026-routing/test-a-bring-your-own-router-endpoint-and-save-it-if-it-passes-admins"},{"title":"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/update_provider_preference","href":"/api-reference/admin:-models-\u0026-routing/choose-which-provider-serves-open-weight-models-several-providers-host:-a-preset-or-custom-pricelatencyreliability-balance-fixed-traffic-shares-a-pinned-provider-exclusions-and-stickiness-admins"},{"title":"Replace the org's Auto-router enrollment and/or blocklist (admins)","description":"Replace the org's Auto-router enrollment and/or blocklist (admins). Runs as the token's owner within their role; the portal's own authorization and audit log apply.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/update_router_selections","href":"/api-reference/admin:-models-\u0026-routing/replace-the-orgs-auto-router-enrollment-andor-blocklist-admins"},{"title":"Rebalance the Auto router and/or replace its plain-language instructions (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/update_router_tuning","href":"/api-reference/admin:-models-\u0026-routing/rebalance-the-auto-router-andor-replace-its-plain-language-instructions-admins"},{"title":"Turn per-turn tier switching on or off and set its efficient model, sensitivity, and reasoning effort (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/update_tier_routing","href":"/api-reference/admin:-models-\u0026-routing/turn-per-turn-tier-switching-on-or-off-and-set-its-efficient-model-sensitivity-and-reasoning-effort-admins"}]},{"group":"Admin: Organization","pages":[{"title":"Answer an open classification question — sets the business function for ALL usage under that key/team/user (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/answer_classification_question","href":"/api-reference/admin:-organization/answer-an-open-classification-question-—-sets-the-business-function-for-all-usage-under-that-keyteamuser-admins"},{"title":"Clear one usage row's business-function label (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/clear_classification","href":"/api-reference/admin:-organization/clear-one-usage-rows-business-function-label-admins"},{"title":"Confirm or correct one usage row's business-function label (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/confirm_classification","href":"/api-reference/admin:-organization/confirm-or-correct-one-usage-rows-business-function-label-admins"},{"title":"Dismiss every current needs-attention item (recurring issues resurface) (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/dismiss_attention_items","href":"/api-reference/admin:-organization/dismiss-every-current-needs-attention-item-recurring-issues-resurface-admins"},{"title":"Why one usage row carries its business-function label (decision, authority, classifier call)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_classification_provenance","href":"/api-reference/admin:-organization/why-one-usage-row-carries-its-business-function-label-decision-authority-classifier-call"},{"title":"Labeled-coverage totals for classification analytics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_classification_summary","href":"/api-reference/admin:-organization/labeled-coverage-totals-for-classification-analytics"},{"title":"What needs an admin's eyes today (budget alerts, stale keys, spend spikes)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_needs_attention","href":"/api-reference/admin:-organization/what-needs-an-admins-eyes-today-budget-alerts-stale-keys-spend-spikes"},{"title":"Read the organization's branding settings (whitelabeling, window title, logo presence)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_org_branding","href":"/api-reference/admin:-organization/read-the-organizations-branding-settings-whitelabeling-window-title-logo-presence"},{"title":"Count stored conversation rows (what a purge would delete)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_stored_content_count","href":"/api-reference/admin:-organization/count-stored-conversation-rows-what-a-purge-would-delete"},{"title":"List classification records with date/category/state filters","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_classification_records","href":"/api-reference/admin:-organization/list-classification-records-with-datecategorystate-filters"},{"title":"List API keys, teams, and users whose business-function classification awaits an admin's answer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_needs_input_classifications","href":"/api-reference/admin:-organization/list-api-keys-teams-and-users-whose-business-function-classification-awaits-an-admins-answer"},{"title":"List the organization's verified sign-in email domains","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_signin_domains","href":"/api-reference/admin:-organization/list-the-organizations-verified-sign-in-email-domains"},{"title":"Remove the organization logo and turn whitelabeling off (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/remove_org_logo","href":"/api-reference/admin:-organization/remove-the-organization-logo-and-turn-whitelabeling-off-admins"},{"title":"Turn business-function classification of new usage on or off (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_classification_enabled","href":"/api-reference/admin:-organization/turn-business-function-classification-of-new-usage-on-or-off-admins"},{"title":"Turn org-wide storage of prompt/response text on or off (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_content_logging","href":"/api-reference/admin:-organization/turn-org-wide-storage-of-promptresponse-text-on-or-off-admins"},{"title":"Set or clear the days stored chat content is retained before the scheduled purge deletes it (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_content_retention","href":"/api-reference/admin:-organization/set-or-clear-the-days-stored-chat-content-is-retained-before-the-scheduled-purge-deletes-it-admins"},{"title":"Turn whitelabeled branding on or off (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_whitelabeling","href":"/api-reference/admin:-organization/turn-whitelabeled-branding-on-or-off-admins"},{"title":"Set or clear the custom browser window title (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_window_title","href":"/api-reference/admin:-organization/set-or-clear-the-custom-browser-window-title-admins"},{"title":"Update or toggle the organization context text shared with every chat (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/update_org_context","href":"/api-reference/admin:-organization/update-or-toggle-the-organization-context-text-shared-with-every-chat-admins"},{"title":"Update or toggle the organization-wide chat instructions (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/update_org_instructions","href":"/api-reference/admin:-organization/update-or-toggle-the-organization-wide-chat-instructions-admins"}]},{"group":"Admin: Personal","pages":[{"title":"Create a personal API key (the secret is shown to the user once, in the card)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/create_api_key","href":"/api-reference/admin:-personal/create-a-personal-api-key-the-secret-is-shown-to-the-user-once-in-the-card"},{"title":"The caller's own spend cap and team budget with remaining headroom","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_my_budget_status","href":"/api-reference/admin:-personal/the-callers-own-spend-cap-and-team-budget-with-remaining-headroom"},{"title":"Usage summary for the caller's visible scope (self, team, or org by role): totals, top models, active users, spend leaderboard","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_my_usage_summary","href":"/api-reference/admin:-personal/usage-summary-for-the-callers-visible-scope-self-team-or-org-by-role:-totals-top-models-active-users-spend-leaderboard"},{"title":"The caller's own API keys, masked, with the ids revoke_api_key needs and optional 30-day usage","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_my_api_keys","href":"/api-reference/admin:-personal/the-callers-own-api-keys-masked-with-the-ids-revoke_api_key-needs-and-optional-30-day-usage"},{"title":"Revoke one of the user's own API keys (irreversible)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/revoke_api_key","href":"/api-reference/admin:-personal/revoke-one-of-the-users-own-api-keys-irreversible"},{"title":"Set the user's personal default chat model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_default_model","href":"/api-reference/admin:-personal/set-the-users-personal-default-chat-model"}]},{"group":"Admin: Teams \u0026 Budgets","pages":[{"title":"Move a member to another team (admins; team leads within their own org), or to Unassigned (admins only)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/assign_user_to_team","href":"/api-reference/admin:-teams-\u0026-budgets/move-a-member-to-another-team-admins;-team-leads-within-their-own-org-or-to-unassigned-admins-only"},{"title":"Move several members to one team (or Unassigned) atomically (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/bulk_assign_users_to_team","href":"/api-reference/admin:-teams-\u0026-budgets/move-several-members-to-one-team-or-unassigned-atomically-admins"},{"title":"Create a team, optionally as a sub-team of an existing one (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/create_team","href":"/api-reference/admin:-teams-\u0026-budgets/create-a-team-optionally-as-a-sub-team-of-an-existing-one-admins"},{"title":"Delete an empty team — refused while it still has members or sub-teams (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/delete_team","href":"/api-reference/admin:-teams-\u0026-budgets/delete-an-empty-team-—-refused-while-it-still-has-members-or-sub-teams-admins"},{"title":"Read the organization-wide spend cap, current spend, and budget period (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_client_spend_summary","href":"/api-reference/admin:-teams-\u0026-budgets/read-the-organization-wide-spend-cap-current-spend-and-budget-period-admins"},{"title":"Read the budget allocation table: client cap, per-team allocations and spend, the Unassigned pool, and per-team headroom (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_team_allocations","href":"/api-reference/admin:-teams-\u0026-budgets/read-the-budget-allocation-table:-client-cap-per-team-allocations-and-spend-the-unassigned-pool-and-per-team-headroom-admins"},{"title":"List per-user spend caps with lifetime spend — only users that HAVE a cap appear; everyone else is uncapped (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_user_spend_caps","href":"/api-reference/admin:-teams-\u0026-budgets/list-per-user-spend-caps-with-lifetime-spend-—-only-users-that-have-a-cap-appear;-everyone-else-is-uncapped-admins"},{"title":"Remove a team's explicit budget allocation (admins; team leads for teams strictly below their own)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/remove_team_cap","href":"/api-reference/admin:-teams-\u0026-budgets/remove-a-teams-explicit-budget-allocation-admins;-team-leads-for-teams-strictly-below-their-own"},{"title":"Remove the Unassigned pool budget cap — team-less users fall back to the client cap (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/remove_unassigned_pool_cap","href":"/api-reference/admin:-teams-\u0026-budgets/remove-the-unassigned-pool-budget-cap-—-team-less-users-fall-back-to-the-client-cap-admins"},{"title":"Remove a member's personal spend cap — they fall back to team/organization limits (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/remove_user_spend_cap","href":"/api-reference/admin:-teams-\u0026-budgets/remove-a-members-personal-spend-cap-—-they-fall-back-to-teamorganization-limits-admins"},{"title":"Rename a team (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/rename_team","href":"/api-reference/admin:-teams-\u0026-budgets/rename-a-team-admins"},{"title":"Set or clear the organization-wide spend cap in USD (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_client_spend_cap","href":"/api-reference/admin:-teams-\u0026-budgets/set-or-clear-the-organization-wide-spend-cap-in-usd-admins"},{"title":"Set a team's total budget allocation in USD (admins; team leads for teams strictly below their own)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_team_cap","href":"/api-reference/admin:-teams-\u0026-budgets/set-a-teams-total-budget-allocation-in-usd-admins;-team-leads-for-teams-strictly-below-their-own"},{"title":"Set the budget cap for the Unassigned pool — users without a team (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_unassigned_pool_cap","href":"/api-reference/admin:-teams-\u0026-budgets/set-the-budget-cap-for-the-unassigned-pool-—-users-without-a-team-admins"},{"title":"Grant or revoke a member's manager role — their own org node with budget and member control (admins; team leads within their own org)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_user_boss_status","href":"/api-reference/admin:-teams-\u0026-budgets/grant-or-revoke-a-members-manager-role-—-their-own-org-node-with-budget-and-member-control-admins;-team-leads-within-their-own-org"},{"title":"Set a member's personal spend cap in USD, optionally with request-rate limits (admins)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/set_user_spend_cap","href":"/api-reference/admin:-teams-\u0026-budgets/set-a-members-personal-spend-cap-in-usd-optionally-with-request-rate-limits-admins"}]},{"group":"Admin: Training","pages":[{"title":"Cancel a running fine-tuning run (the reservation is released once the backend confirms)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/cancel_training_run","href":"/api-reference/admin:-training/cancel-a-running-fine-tuning-run-the-reservation-is-released-once-the-backend-confirms"},{"title":"Create a dataset folder (datasets/\u003cname>/) in the organization's training bucket","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/create_training_dataset","href":"/api-reference/admin:-training/create-a-dataset-folder-datasets\u003cname>-in-the-organizations-training-bucket"},{"title":"Serve a trained model on a dedicated endpoint (per hour); serverless is not available for trained adapters yet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/deploy_training_model","href":"/api-reference/admin:-training/serve-a-trained-model-on-a-dedicated-endpoint-per-hour;-serverless-is-not-available-for-trained-adapters-yet"},{"title":"Enable the AWS hub for training: create the organization's own AWS account (idempotent; the training bucket is vended in it)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/enable_training_account","href":"/api-reference/admin:-training/enable-the-aws-hub-for-training:-create-the-organizations-own-aws-account-idempotent;-the-training-bucket-is-vended-in-it"},{"title":"One fine-tuning run: state, cost, and the model id once succeeded","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_training_run","href":"/api-reference/admin:-training/one-fine-tuning-run:-state-cost-and-the-model-id-once-succeeded"},{"title":"The exact aws s3 cp / sync lines to put chat-format JSONL into a dataset folder, and the data format","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_training_upload_recipe","href":"/api-reference/admin:-training/the-exact-aws-s3-cp-sync-lines-to-put-chat-format-jsonl-into-a-dataset-folder-and-the-data-format"},{"title":"The organization's training storage (bucket), datasets with validation state, runs, models and deployments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/get_training_workspace","href":"/api-reference/admin:-training/the-organizations-training-storage-bucket-datasets-with-validation-state-runs-models-and-deployments"},{"title":"The base models that can be fine-tuned, with the methods (lora/full) and serving modes available for each","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/list_training_bases","href":"/api-reference/admin:-training/the-base-models-that-can-be-fine-tuned-with-the-methods-lorafull-and-serving-modes-available-for-each"},{"title":"Mint a 12-hour AWS session scoped to one dataset folder for aws s3 cp (renders in the portal only, once)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/mint_training_upload_session","href":"/api-reference/admin:-training/mint-a-12-hour-aws-session-scoped-to-one-dataset-folder-for-aws-s3-cp-renders-in-the-portal-only-once"},{"title":"Price a fine-tuning run (non-spending): estimated tokens, cost, minutes, serving price, and a quoteId valid 120 s","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/quote_training_run","href":"/api-reference/admin:-training/price-a-fine-tuning-run-non-spending:-estimated-tokens-cost-minutes-serving-price-and-a-quoteid-valid-120-s"},{"title":"Start a fine-tuning run from a quoteId (or the full request); reserves the estimate from the wallet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/start_training_run","href":"/api-reference/admin:-training/start-a-fine-tuning-run-from-a-quoteid-or-the-full-request;-reserves-the-estimate-from-the-wallet"},{"title":"Stop serving a trained model (ends hourly billing)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/stop_training_deployment","href":"/api-reference/admin:-training/stop-serving-a-trained-model-ends-hourly-billing"},{"title":"Pin and validate a dataset's training file (chat JSONL); produces the example and token counts a quote prices from","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/admin/validate_training_dataset","href":"/api-reference/admin:-training/pin-and-validate-a-datasets-training-file-chat-jsonl;-produces-the-example-and-token-counts-a-quote-prices-from"}]}]}]}]},"title":"Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins) - AI Reserve Developer Documentation","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}