[{"data":1,"prerenderedAt":500},["ShallowReactive",2],{"navigation_docs":3,"-administration-organizations-and-projects":160,"-administration-organizations-and-projects-surround":495},[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":110,"body":162,"description":488,"extension":489,"links":490,"meta":491,"navigation":492,"path":111,"seo":493,"stem":112,"__hash__":494},"docs\u002F5.administration\u002F1.organizations-and-projects.md",{"type":163,"value":164,"toc":475},"minimark",[165,169,179,184,190,194,202,207,212,233,236,242,246,263,273,284,291,354,364,370,385,396,400,423,426,429,433,437,454,458],[166,167,168],"p",{},"An organization contains projects, and projects contain applications. Use this structure to group applications in the way that best suits your organization: by products, environments, departments, and countries, all while keeping application access and configuration manageable.",[170,171,174,175,178],"who-panel",{":applies-to":172,":roles":173},"[\"LLM requests\", \"Tool calls\"]","[\"Organization Admin\", \"Workspace Admin\", \"Project Admin\", \"App Admin\"]","Organization Admins and Workspace Admins manage projects. Organization Admins, Workspace Admins, and Project Admins can create applications; App Admins can configure them. See ",[176,177,115],"a",{"href":116}," for each role's permissions.",[180,181,183],"h2",{"id":182},"why-use-it","Why use it",[166,185,186,187,189],{},"Projects group applications that share an owner or purpose, such as a product, environment, or customer. Project-level access then applies to the applications in that project, so you can manage related workloads together. See ",[176,188,115],{"href":116}," for role scopes.",[180,191,193],{"id":192},"how-it-works","How it works",[166,195,196,197,201],{},"An organization contains projects, and each project contains applications. Every application belongs to exactly one project. Each organization has a ",[198,199,200],"strong",{},"Default"," project, so every application has a project even when you have not created another.",[203,204],"hierarchy-diagram",{":branches":205,":root":206},"[{\"title\":\"Default project\",\"badge\":\"Always included\",\"description\":\"A project ready to use in every organization.\",\"icon\":\"i-lucide-boxes\",\"children\":[{\"title\":\"Applications\",\"description\":\"Each application belongs to one project.\",\"icon\":\"i-lucide-box\"}]},{\"title\":\"Other projects\",\"badge\":\"Create as needed\",\"description\":\"Group work by product, environment, or customer.\",\"icon\":\"i-lucide-boxes\",\"children\":[{\"title\":\"Applications\",\"description\":\"Each application belongs to one project.\",\"icon\":\"i-lucide-box\"}]}]","{\"title\":\"Organization\",\"description\":\"One account for members, settings, projects, and applications.\",\"icon\":\"i-lucide-building-2\"}",[208,209,211],"h3",{"id":210},"projects","Projects",[166,213,214,215,218,219,218,222,225,226,229,230,232],{},"Use a project to keep applications with a shared purpose together. For example, you might separate development and production applications, or group applications by customer. Give the project a name, add an optional description so teammates know what belongs there, and choose a risk level: ",[198,216,217],{},"Unassigned",", ",[198,220,221],{},"Low",[198,223,224],{},"Medium",", or ",[198,227,228],{},"High",". Projects also have a slug; you can edit it later, except for the ",[198,231,200],{}," project's fixed slug.",[166,234,235],{},"Use the Projects list to compare projects at a glance. The application count shows how many applications each project groups, and request activity helps you see which projects are handling traffic. Risk level and creation and update dates provide more context. Budget (for projects where it was set) shows how much the applications within a project are spending. Search, filter, or sort the list to find a project.",[166,237,238,239,241],{},"Open a project when you want to work with the applications it groups. Their status and request activity help you spot which ones are active or receiving traffic; creation and update dates help you find recent changes. Search or sort the list, filter by status. You can create an application from the project page. To delete a project, first delete all its applications. Project roles apply to every application in that project; see ",[176,240,115],{"href":116}," for details.",[208,243,245],{"id":244},"applications","Applications",[166,247,248,249,251,252,218,254,256,257,259,260,262],{},"Think of an application as one AI workload, such as a product assistant or a staging service. It belongs to one project, but its settings let you decide how that workload uses Optiak. For example, you can choose which models it can call, add available data and tools, and set application-specific guardrails. Organization policies can limit which options are available. See ",[176,250,69],{"href":70}," for organization-wide restrictions, ",[176,253,33],{"href":34},[176,255,48],{"href":49},", and ",[176,258,53],{"href":54}," for application settings, and ",[176,261,115],{"href":116}," for the roles that can change them.",[166,264,265,266,268,269,272],{},"The application's ",[198,267,28],{}," shows the ",[176,270,271],{"href":90},"Dashboard"," for that application only.",[166,274,275,276,279,280,283],{},"When you need to understand one call, open the application's ",[198,277,278],{},"Requests"," tab. Each request has a trace showing the steps it went through. See ",[176,281,282],{"href":95},"Application Observability"," for how to use those traces to investigate failures, blocks, or delays.",[166,285,286,287,290],{},"Use ",[198,288,289],{},"Configuration"," to decide how the application behaves:",[292,293,294,308,324,336,345],"ul",{},[295,296,297,300,301,304,305,307],"li",{},[198,298,299],{},"General",": In ",[198,302,303],{},"Details & status",", identify the application and choose its project or whether it is active. ",[198,306,145],{}," help you set spending limits for its traffic.",[295,309,310,313,314,317,318,320,321,323],{},[198,311,312],{},"Capabilities",": Choose the ",[176,315,316],{"href":34},"models"," it can call, configure ",[176,319,38],{"href":39}," and the ",[176,322,43],{"href":44},", and set request defaults such as fallback models and the system prompt.",[295,325,326,329,330,332,333,335],{},[198,327,328],{},"Data & tools",": Enable the ",[176,331,48],{"href":49}," and ",[176,334,53],{"href":54}," this application needs from the options made available by the organization.",[295,337,338,341,342,344],{},[198,339,340],{},"Security",": Set ",[176,343,58],{"href":59}," to check application traffic against your safety policy.",[295,346,347,350,351,353],{},[198,348,349],{},"Access",": Manage the Application API keys your services use to call this application. Keys are specific to an application; see ",[176,352,120],{"href":121}," for key creation and revocation.",[166,355,356,357,360,361,363],{},"These settings shape how the Gateway handles this application's traffic. See the ",[176,358,359],{"href":29},"Gateway overview"," for how a request flows through Optiak, or ",[176,362,282],{"href":95}," for more about metrics and traces.",[166,365,366,367,369],{},"Create an application in the project where it belongs. See ",[176,368,115],{"href":116}," for role permissions.",[166,371,372,373,376,377,380,381,384],{},"To let a service call this application through the Gateway, create an ",[198,374,375],{},"Application API key"," in ",[198,378,379],{},"Configuration -> Credentials",". Each key is tied to one application; see ",[176,382,120],{"href":383},"\u002Fadministration\u002Fauthentication#application-api-keys"," for setup and revocation.",[166,386,387,388,391,392,395],{},"Applications can be ",[198,389,390],{},"Active"," or ",[198,393,394],{},"Paused",". A paused application rejects Gateway requests made with its API keys until you activate it again; pausing does not delete the application or its credentials.",[180,397,399],{"id":398},"set-it-up","Set it up",[166,401,402,403,405,406,409,410,412,413,416,417,419,420,422],{},"In the console, open ",[198,404,211],{},". Create a project with ",[198,407,408],{},"Create project",", or select an existing project, including ",[198,411,200],{},". From a project, choose ",[198,414,415],{},"Create application"," and enter the application details. You can change its settings later in ",[198,418,289],{},"; use ",[198,421,303],{}," to pause, activate, or delete it.",[166,424,425],{},"If you leave the application creation form before finishing, the console keeps your progress as a draft for up to 7 days and shows a reminder so you can resume where you left off.",[166,427,428],{},"For example, a company could keep an internal knowledge assistant in Default, put its live support and invoice assistants in Production, and keep their test versions in Development. Each application belongs to one project, so production traffic stays separate from development while the projects remain part of the same organization.",[203,430],{":branches":431,":root":432},"[{\"title\":\"Default project\",\"badge\":\"Always included\",\"description\":\"Use when an application does not need a separate project.\",\"icon\":\"i-lucide-boxes\",\"children\":[{\"title\":\"Internal knowledge assistant\",\"description\":\"Answers employee questions.\",\"icon\":\"i-lucide-box\"}]},{\"title\":\"Production project\",\"badge\":\"Example\",\"description\":\"Groups customer-facing applications.\",\"icon\":\"i-lucide-boxes\",\"children\":[{\"title\":\"Support assistant\",\"description\":\"Helps customers find answers.\",\"icon\":\"i-lucide-box\"},{\"title\":\"Invoice assistant\",\"description\":\"Extracts details from invoices.\",\"icon\":\"i-lucide-box\"}]},{\"title\":\"Dev project\",\"badge\":\"Example\",\"description\":\"Keeps test applications separate from live traffic.\",\"icon\":\"i-lucide-boxes\",\"children\":[{\"title\":\"Support assistant (staging)\",\"description\":\"Tests before release.\",\"icon\":\"i-lucide-box\"},{\"title\":\"Invoice assistant (staging)\",\"description\":\"Tests before release.\",\"icon\":\"i-lucide-box\"}]}]","{\"title\":\"ACME Inc.\",\"description\":\"Where crazy ideas become real.\",\"icon\":\"i-lucide-building-2\"}",[180,434,436],{"id":435},"limits-and-behavior","Limits and behavior",[292,438,439,445,448],{},[295,440,441,442,444],{},"You cannot delete the ",[198,443,200],{}," project. A project must have no applications before you can delete it; delete its applications first.",[295,446,447],{},"Pausing is reversible and preserves the application and its credentials, but requests using its API keys are rejected until it is active again.",[295,449,450,451,453],{},"Deleting an application is irreversible and stops its Gateway traffic. Plan to retire or replace services using its Application API keys before deleting it; see ",[176,452,120],{"href":121}," for key management.",[180,455,457],{"id":456},"related","Related",[292,459,460,465,470],{},[295,461,462,464],{},[176,463,115],{"href":116},": role permissions and project-level access.",[295,466,467,469],{},[176,468,120],{"href":121},": Application API keys and organization connections.",[295,471,472,474],{},[176,473,145],{"href":146},": organization, project, application, and key spending limits.",{"title":476,"searchDepth":477,"depth":477,"links":478},"",2,[479,480,485,486,487],{"id":182,"depth":477,"text":183},{"id":192,"depth":477,"text":193,"children":481},[482,484],{"id":210,"depth":483,"text":211},3,{"id":244,"depth":483,"text":245},{"id":398,"depth":477,"text":399},{"id":435,"depth":477,"text":436},{"id":456,"depth":477,"text":457},"How projects group applications and how you manage them.","md",null,{},{"icon":113},{"title":110,"description":488},"VUfgDxlfMgEcTCpdxQxkSmgsO1ih1eMPCMKz4tqdWOM",[496,498],{"title":99,"path":100,"stem":101,"description":497,"icon":102,"children":-1},"The definition of every metric in the console, and how Optiak calculates it.",{"title":115,"path":116,"stem":117,"description":499,"icon":118,"children":-1},"Manage who can join your organization and what each person or group can access.",1795006120970]