[{"data":1,"prerenderedAt":542},["ShallowReactive",2],{"navigation_docs":3,"-administration-authentication":160,"-administration-authentication-surround":537},[4,21,62,82,103,149],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":20},"Get Started","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,15],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-info",{"title":16,"path":17,"stem":18,"icon":19},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart","i-lucide-play-circle",false,{"title":22,"icon":23,"path":24,"stem":25,"children":26,"page":20},"Gateway","i-lucide-network","\u002Fgateway","2.gateway",[27,32,37,42,47,52,57],{"title":28,"path":29,"stem":30,"icon":31},"Overview","\u002Fgateway\u002Foverview","2.gateway\u002F1.overview","i-lucide-waypoints",{"title":33,"path":34,"stem":35,"icon":36},"Models and Routing","\u002Fgateway\u002Fmodels-and-routing","2.gateway\u002F2.models-and-routing","i-lucide-brain",{"title":38,"path":39,"stem":40,"icon":41},"Smart Router","\u002Fgateway\u002Fsmart-routing","2.gateway\u002F3.smart-routing","i-lucide-route",{"title":43,"path":44,"stem":45,"icon":46},"Context Engine","\u002Fgateway\u002Fcontext-engine","2.gateway\u002F4.context-engine","i-product-context-engine",{"title":48,"path":49,"stem":50,"icon":51},"Data Integrations","\u002Fgateway\u002Fdata-integrations","2.gateway\u002F5.data-integrations","i-lucide-database",{"title":53,"path":54,"stem":55,"icon":56},"Tools","\u002Fgateway\u002Ftools","2.gateway\u002F6.tools","i-lucide-wrench",{"title":58,"path":59,"stem":60,"icon":61},"Guardrails","\u002Fgateway\u002Fguardrails","2.gateway\u002F7.guardrails","i-lucide-shield-alert",{"title":63,"icon":64,"path":65,"stem":66,"children":67,"page":20},"Compliance","i-lucide-shield-check","\u002Fcompliance","3.compliance",[68,72,77],{"title":69,"path":70,"stem":71,"icon":64},"Data Governance","\u002Fcompliance\u002Fdata-governance","3.compliance\u002F01.data-governance",{"title":73,"path":74,"stem":75,"icon":76},"Network Access","\u002Fcompliance\u002Fnetwork-access","3.compliance\u002F02.network-access","i-lucide-lock",{"title":78,"path":79,"stem":80,"icon":81},"Audit Logs","\u002Fcompliance\u002Faudit-logs","3.compliance\u002F03.audit-logs","i-lucide-scroll-text",{"title":83,"icon":84,"path":85,"stem":86,"children":87,"page":20},"Observability","i-lucide-eye","\u002Fobservability","4.observability",[88,93,98],{"title":89,"path":90,"stem":91,"icon":92},"Organization","\u002Fobservability\u002Forganization","4.observability\u002F1.organization","i-lucide-building-2",{"title":94,"path":95,"stem":96,"icon":97},"Application","\u002Fobservability\u002Fapplication","4.observability\u002F2.application","i-lucide-activity",{"title":99,"path":100,"stem":101,"icon":102},"Metrics","\u002Fobservability\u002Fmetrics","4.observability\u002F3.metrics","i-lucide-bar-chart-2",{"title":104,"icon":105,"path":106,"stem":107,"children":108,"page":20},"Administration","i-lucide-settings","\u002Fadministration","5.administration",[109,114,119,129,144],{"title":110,"path":111,"stem":112,"icon":113},"Organization and Projects","\u002Fadministration\u002Forganizations-and-projects","5.administration\u002F1.organizations-and-projects","i-lucide-box",{"title":115,"path":116,"stem":117,"icon":118},"Members and Access","\u002Fadministration\u002Fmembers-and-access","5.administration\u002F2.members-and-access","i-lucide-shield-user",{"title":120,"path":121,"stem":122,"children":123,"icon":76},"Authentication","\u002Fadministration\u002Fauthentication","5.administration\u002F3.authentication",[124],{"title":125,"path":126,"stem":127,"icon":128},"Connect Model APIs","\u002Fadministration\u002Fauthentication\u002Fconnect-model-apis","5.administration\u002F3.authentication\u002F31.connect-model-apis","i-lucide-cpu",{"title":130,"path":131,"stem":132,"children":133,"icon":143},"Connections","\u002Fadministration\u002Fconnections","5.administration\u002F4.connections",[134,139],{"title":135,"path":136,"stem":137,"icon":138},"Connect MCP Servers","\u002Fadministration\u002Fconnections\u002Fmcp-connections","5.administration\u002F4.connections\u002F42.mcp-connections","i-lucide-plug",{"title":140,"path":141,"stem":142,"icon":51},"Connect Data Sources","\u002Fadministration\u002Fconnections\u002Fdata-sources-connections","5.administration\u002F4.connections\u002F43.data-sources-connections","i-lucide-link",{"title":145,"path":146,"stem":147,"icon":148},"Budgets","\u002Fadministration\u002Fbudgets","5.administration\u002F5.budgets","i-lucide-wallet",{"title":150,"icon":151,"path":152,"stem":153,"children":154,"page":20},"Reference","i-lucide-book-open","\u002Freference","6.reference",[155],{"title":156,"path":157,"stem":158,"icon":159},"Using the API","\u002Freference\u002Fapi-usage","6.reference\u002F1.api-usage","i-lucide-terminal-square",{"id":161,"title":120,"body":162,"description":530,"extension":531,"links":532,"meta":533,"navigation":534,"path":121,"seo":535,"stem":122,"__hash__":536},"docs\u002F5.administration\u002F3.authentication.md",{"type":163,"value":164,"toc":518},"minimark",[165,173,179,184,187,191,195,199,202,207,231,234,238,246,282,396,402,412,441,445,453,457,481,485,493,497,514],[166,167,168,169,172],"p",{},"Your services use the same Application API key to call both the Gateway and MCP Gateway. Optiak uses provider credentials to call models on your behalf. Keep these credentials distinct from ",[170,171,130],"a",{"href":131},", which give Optiak access to tools and data sources.",[174,175,178],"who-panel",{":applies-to":176,":roles":177},"[\"LLM requests\", \"Tool calls\"]","[\"Organization Admin\", \"Workspace Admin\", \"Project Admin\", \"App Admin\"]","Organization Admins manage provider credentials and subscription access. Admins who manage an application can create and revoke its Application API keys.",[180,181,183],"h2",{"id":182},"why-use-it","Why use it",[166,185,186],{},"Each credential connects a different pair of systems. An Application API key identifies your application to the Gateway. A provider key or supported subscription lets Optiak access model-provider services. Keeping these credentials separate limits what each one can reach.",[180,188,190],{"id":189},"how-it-works","How it works",[192,193],"audit-coverage",{":areas":194},"[{\"label\":\"Application API key\",\"summary\":\"Your service authenticates to Optiak for one application.\",\"icon\":\"i-lucide-key-round\",\"actions\":[{\"resource\":\"Used by\",\"description\":\"Your service, when it calls the Gateway.\"},{\"resource\":\"Reaches\",\"description\":\"The Gateway API and tools enabled for that application.\"},{\"resource\":\"Manage in\",\"description\":\"Projects → application → Configuration → Credentials.\"}]},{\"label\":\"Provider credentials\",\"summary\":\"Optiak authenticates to model providers on your organization's behalf.\",\"icon\":\"i-lucide-cpu\",\"actions\":[{\"resource\":\"Provider API key\",\"description\":\"Calls models available through the provider account.\"},{\"resource\":\"Provider subscription\",\"description\":\"Makes subscription-backed models, such as Codex, available to the organization.\"},{\"resource\":\"Manage in\",\"description\":\"Company setup → Providers.\"}]}]",[180,196,198],{"id":197},"application-api-keys","Application API keys",[166,200,201],{},"Your service sends an Application API key to authenticate with the Gateway. Each key belongs to one application, so requests made with it use that application's available models and settings. The same key can access the application's enabled tools through the MCP Gateway.",[203,204,206],"h3",{"id":205},"create-a-key","Create a key",[166,208,209,210,214,215,218,219,222,223,226,227,230],{},"In the console, open ",[211,212,213],"strong",{},"Projects",", switch to ",[211,216,217],{},"Applications",", select the application, then open ",[211,220,221],{},"Configuration"," → ",[211,224,225],{},"Credentials"," and select ",[211,228,229],{},"Create API key",". Give the key a name so you can recognize which service uses it. A label and description are optional. Choose how long it should work: no expiration, 7 days, 30 days, 90 days, or 1 year. After it expires, it can no longer authenticate requests.",[166,232,233],{},"Copy the full key when it is created. Optiak shows the full value only once; afterward, the list shows only its prefix. Optiak stores only a one-way fingerprint of the key, not the secret itself, so the original key cannot be read back from Optiak.",[203,235,237],{"id":236},"use-a-key","Use a key",[166,239,240,241,245],{},"Send the key as a bearer token in the ",[242,243,244],"code",{},"Authorization"," header. For example:",[247,248,253],"pre",{"className":249,"code":250,"language":251,"meta":252,"style":252},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","export OPTIAK_BASE_URL=\"https:\u002F\u002Fapi.optiak.dev\u002Fv1\"\n","bash","",[242,254,255],{"__ignoreMap":252},[256,257,260,264,268,272,275,279],"span",{"class":258,"line":259},"line",1,[256,261,263],{"class":262},"spNyl","export",[256,265,267],{"class":266},"sTEyZ"," OPTIAK_BASE_URL",[256,269,271],{"class":270},"sMK4o","=",[256,273,274],{"class":270},"\"",[256,276,278],{"class":277},"sfazB","https:\u002F\u002Fapi.optiak.dev\u002Fv1",[256,280,281],{"class":270},"\"\n",[247,283,285],{"className":249,"code":284,"language":251,"meta":252,"style":252},"export OPTIAK_API_KEY=\"your_application_api_key\"\n\ncurl \"$OPTIAK_BASE_URL\u002Fchat\u002Fcompletions\" \\\n  -H \"Authorization: Bearer $OPTIAK_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"codex\u002Fgpt-6-luna\",\n    \"messages\": [{ \"role\": \"user\", \"content\": \"Hello\" }]\n  }'\n",[242,286,287,303,310,331,349,363,375,381,387],{"__ignoreMap":252},[256,288,289,291,294,296,298,301],{"class":258,"line":259},[256,290,263],{"class":262},[256,292,293],{"class":266}," OPTIAK_API_KEY",[256,295,271],{"class":270},[256,297,274],{"class":270},[256,299,300],{"class":277},"your_application_api_key",[256,302,281],{"class":270},[256,304,306],{"class":258,"line":305},2,[256,307,309],{"emptyLinePlaceholder":308},true,"\n",[256,311,313,317,320,323,326,328],{"class":258,"line":312},3,[256,314,316],{"class":315},"sBMFI","curl",[256,318,319],{"class":270}," \"",[256,321,322],{"class":266},"$OPTIAK_BASE_URL",[256,324,325],{"class":277},"\u002Fchat\u002Fcompletions",[256,327,274],{"class":270},[256,329,330],{"class":266}," \\\n",[256,332,334,337,339,342,345,347],{"class":258,"line":333},4,[256,335,336],{"class":277},"  -H",[256,338,319],{"class":270},[256,340,341],{"class":277},"Authorization: Bearer ",[256,343,344],{"class":266},"$OPTIAK_API_KEY",[256,346,274],{"class":270},[256,348,330],{"class":266},[256,350,352,354,356,359,361],{"class":258,"line":351},5,[256,353,336],{"class":277},[256,355,319],{"class":270},[256,357,358],{"class":277},"Content-Type: application\u002Fjson",[256,360,274],{"class":270},[256,362,330],{"class":266},[256,364,366,369,372],{"class":258,"line":365},6,[256,367,368],{"class":277},"  -d",[256,370,371],{"class":270}," '",[256,373,374],{"class":277},"{\n",[256,376,378],{"class":258,"line":377},7,[256,379,380],{"class":277},"    \"model\": \"codex\u002Fgpt-6-luna\",\n",[256,382,384],{"class":258,"line":383},8,[256,385,386],{"class":277},"    \"messages\": [{ \"role\": \"user\", \"content\": \"Hello\" }]\n",[256,388,390,393],{"class":258,"line":389},9,[256,391,392],{"class":277},"  }",[256,394,395],{"class":270},"'\n",[166,397,398,399,401],{},"For a guided walkthrough from provider setup to your first request, see the ",[170,400,16],{"href":17},".",[166,403,404,405,408,409,401],{},"Use ",[242,406,407],{},"GET \u002Fmodels"," to check which model IDs the key can access. The same key can call the application's enabled MCP tools; see ",[170,410,53],{"href":411},"\u002Fgateway\u002Ftools#check-which-tools-an-application-can-reach",[413,414,417,422],"callout",{"color":415,"icon":416},"warning","i-lucide-triangle-alert",[166,418,419],{},[211,420,421],{},"Security recommendations",[423,424,425,429,432,435,438],"ul",{},[426,427,428],"li",{},"Never commit an Application API key to a public repository or share it publicly.",[426,430,431],{},"Use one key per integration so you can revoke access to one service without affecting others.",[426,433,434],{},"Set an expiration for temporary tests or short-lived integrations, and rotate long-lived keys regularly.",[426,436,437],{},"Store keys in a secret manager or environment variable, not in application code.",[426,439,440],{},"Revoke a key when its integration is retired or the key may be compromised.",[203,442,444],{"id":443},"revoke-a-key","Revoke a key",[166,446,447,448,222,450,452],{},"Open the application's ",[211,449,221],{},[211,451,225],{}," section and revoke the key. Revocation disables it immediately, so any service using it will stop authenticating.",[180,454,456],{"id":455},"set-it-up","Set it up",[423,458,459,471,476],{},[426,460,461,462,466,467,401],{},"To connect an application to the Gateway, create an ",[170,463,465],{"href":464},"#create-a-key","Application API key",", then ",[170,468,470],{"href":469},"#use-a-key","send it with API requests",[426,472,473,475],{},[170,474,125],{"href":126},": prepare provider keys, connect built-in or custom providers, and make their models available to applications.",[426,477,478,479,401],{},"To connect tools or data sources to Optiak, see ",[170,480,130],{"href":131},[180,482,484],{"id":483},"limits-and-behavior","Limits and behavior",[423,486,487,490],{},[426,488,489],{},"Optiak shows the full value of an Application API key only when it is created. Create another key if the value is lost, and revoke keys that should no longer work.",[426,491,492],{},"A provider API key or subscription does not by itself make every model available to every application. The organization enables models, and applications select from those allowed to them.",[180,494,496],{"id":495},"related","Related",[423,498,499,504,509],{},[426,500,501,503],{},[170,502,130],{"href":131},": authenticate Optiak to external tools and data sources.",[426,505,506,508],{},[170,507,33],{"href":34},": choose the models an application can use.",[426,510,511,513],{},[170,512,156],{"href":157},": call the Gateway with an Application API key.",[515,516,517],"style",{},"html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":252,"searchDepth":305,"depth":305,"links":519},[520,521,522,527,528,529],{"id":182,"depth":305,"text":183},{"id":189,"depth":305,"text":190},{"id":197,"depth":305,"text":198,"children":523},[524,525,526],{"id":205,"depth":312,"text":206},{"id":236,"depth":312,"text":237},{"id":443,"depth":312,"text":444},{"id":455,"depth":305,"text":456},{"id":483,"depth":305,"text":484},{"id":495,"depth":305,"text":496},"Manage the credentials your services and Optiak use to access the Gateway and model providers.","md",null,{},{"icon":76},{"title":120,"description":530},"E26akekk9D1vK4mj4YuXM5ImSZctpf5W1Wcavcrd3U8",[538,540],{"title":115,"path":116,"stem":117,"description":539,"icon":118,"children":-1},"Manage who can join your organization and what each person or group can access.",{"title":125,"path":126,"stem":127,"description":541,"icon":128,"children":-1},"Prepare provider keys and connect the model APIs your applications need.",1795006122968]