[{"data":1,"prerenderedAt":390},["ShallowReactive",2],{"docs-navigation":3,"docs-page-\u002Fdocs\u002Fget-started\u002Fauthentication":149,"docs-surround-\u002Fdocs\u002Fget-started\u002Fauthentication":387},[4],{"title":5,"path":6,"stem":7,"children":8,"page":148},"Docs","\u002Fdocs","docs",[9,36,75,94,129],{"title":10,"path":11,"stem":12,"children":13},"GET STARTED","\u002Fdocs\u002Fget-started","docs\u002F1.get-started\u002F1.index",[14,16,20,24,28,32],{"title":15,"path":11,"stem":12},"Welcome",{"title":17,"path":18,"stem":19},"Quickstart","\u002Fdocs\u002Fget-started\u002Fquickstart","docs\u002F1.get-started\u002F2.quickstart",{"title":21,"path":22,"stem":23},"API","\u002Fdocs\u002Fget-started\u002Fapi","docs\u002F1.get-started\u002F3.api",{"title":25,"path":26,"stem":27},"SDKs and CLI","\u002Fdocs\u002Fget-started\u002Fsdks-cli","docs\u002F1.get-started\u002F4.sdks-cli",{"title":29,"path":30,"stem":31},"Sandbox testing","\u002Fdocs\u002Fget-started\u002Flocal-development","docs\u002F1.get-started\u002F5.local-development",{"title":33,"path":34,"stem":35},"Authentication","\u002Fdocs\u002Fget-started\u002Fauthentication","docs\u002F1.get-started\u002F6.authentication",{"title":37,"path":38,"stem":39,"children":40},"FUNDAMENTALS","\u002Fdocs\u002Ffundamentals","docs\u002F2.fundamentals\u002F1.index",[41,43,47,51,55,59,63,67,71],{"title":42,"path":38,"stem":39},"Fundamentals",{"title":44,"path":45,"stem":46},"Architecture","\u002Fdocs\u002Ffundamentals\u002Farchitecture","docs\u002F2.fundamentals\u002F2.architecture",{"title":48,"path":49,"stem":50},"Memory model","\u002Fdocs\u002Ffundamentals\u002Fmemory-model","docs\u002F2.fundamentals\u002F3.memory-model",{"title":52,"path":53,"stem":54},"Compression","\u002Fdocs\u002Ffundamentals\u002Fcompression","docs\u002F2.fundamentals\u002F4.compression",{"title":56,"path":57,"stem":58},"RAG and cached context","\u002Fdocs\u002Ffundamentals\u002Frag-cag","docs\u002F2.fundamentals\u002F5.rag-cag",{"title":60,"path":61,"stem":62},"Context cache","\u002Fdocs\u002Ffundamentals\u002Fcontext-cache","docs\u002F2.fundamentals\u002F6.context-cache",{"title":64,"path":65,"stem":66},"Security","\u002Fdocs\u002Ffundamentals\u002Fsecurity","docs\u002F2.fundamentals\u002F7.security",{"title":68,"path":69,"stem":70},"Languages","\u002Fdocs\u002Ffundamentals\u002Flanguages","docs\u002F2.fundamentals\u002F8.languages",{"title":72,"path":73,"stem":74},"UI patterns","\u002Fdocs\u002Ffundamentals\u002Fui","docs\u002F2.fundamentals\u002F9.ui",{"title":76,"path":77,"stem":78,"children":79},"AGENTS","\u002Fdocs\u002Fagents","docs\u002F3.agents\u002F1.index",[80,82,86,90],{"title":81,"path":77,"stem":78},"Agents",{"title":83,"path":84,"stem":85},"Agent skills","\u002Fdocs\u002Fagents\u002Fagent-skills","docs\u002F3.agents\u002F2.agent-skills",{"title":87,"path":88,"stem":89},"Admin UI prompt","\u002Fdocs\u002Fagents\u002Fadmin-ui-prompt","docs\u002F3.agents\u002F3.admin-ui-prompt",{"title":91,"path":92,"stem":93},"Codex Code Nucleus","\u002Fdocs\u002Fagents\u002Fcodex-code-nucleus","docs\u002F3.agents\u002F4.codex-code-nucleus",{"title":95,"path":96,"stem":97,"children":98},"PROVIDERS","\u002Fdocs\u002Fproviders","docs\u002F4.providers\u002F1.index",[99,101,105,109,113,117,121,125],{"title":100,"path":96,"stem":97},"Providers",{"title":102,"path":103,"stem":104},"OpenAI and Azure OpenAI","\u002Fdocs\u002Fproviders\u002Fopenai","docs\u002F4.providers\u002F2.openai",{"title":106,"path":107,"stem":108},"Anthropic Claude","\u002Fdocs\u002Fproviders\u002Fanthropic","docs\u002F4.providers\u002F3.anthropic",{"title":110,"path":111,"stem":112},"Google Gemini and Vertex AI","\u002Fdocs\u002Fproviders\u002Fgoogle-gemini","docs\u002F4.providers\u002F4.google-gemini",{"title":114,"path":115,"stem":116},"OpenAI-compatible providers","\u002Fdocs\u002Fproviders\u002Fopenai-compatible","docs\u002F4.providers\u002F5.openai-compatible",{"title":118,"path":119,"stem":120},"Groq","\u002Fdocs\u002Fproviders\u002Fgroq","docs\u002F4.providers\u002F6.groq",{"title":122,"path":123,"stem":124},"Cohere","\u002Fdocs\u002Fproviders\u002Fcohere","docs\u002F4.providers\u002F7.cohere",{"title":126,"path":127,"stem":128},"Amazon Bedrock","\u002Fdocs\u002Fproviders\u002Famazon-bedrock","docs\u002F4.providers\u002F8.amazon-bedrock",{"title":130,"path":131,"stem":132,"children":133},"CHANGELOG","\u002Fdocs\u002Fchangelog","docs\u002F5.changelog\u002F1.index",[134,136,140,144],{"title":135,"path":131,"stem":132},"Changelog",{"title":137,"path":138,"stem":139},"Roadmap","\u002Fdocs\u002Fchangelog\u002Froadmap","docs\u002F5.changelog\u002F2.roadmap",{"title":141,"path":142,"stem":143},"Release notes","\u002Fdocs\u002Fchangelog\u002Frelease-runbook","docs\u002F5.changelog\u002F3.release-runbook",{"title":145,"path":146,"stem":147},"Testing","\u002Fdocs\u002Fchangelog\u002Ftesting","docs\u002F5.changelog\u002F4.testing",false,{"id":150,"title":33,"body":151,"description":381,"extension":382,"meta":383,"navigation":384,"path":34,"seo":385,"stem":35,"__hash__":386},"docs\u002Fdocs\u002F1.get-started\u002F6.authentication.md",{"type":152,"value":153,"toc":373},"minimark",[154,158,162,167,170,206,209,213,230,233,237,294,298,318,321,355,359,362,366,369],[155,156,33],"h1",{"id":157},"authentication",[159,160,161],"p",{},"Neutron AI API requests use bearer tokens. Tokens identify the calling workspace or integration and should be handled as secrets.",[163,164,166],"h2",{"id":165},"token-types","Token types",[159,168,169],{},"Neutron uses two public token boundaries:",[171,172,173,186],"table",{},[174,175,176],"thead",{},[177,178,179,183],"tr",{},[180,181,182],"th",{},"Token",[180,184,185],{},"Use",[187,188,189,198],"tbody",{},[177,190,191,195],{},[192,193,194],"td",{},"Workspace API key",[192,196,197],{},"Setup and control-plane calls, such as creating Nuclei and listing Nuclei linked to the workspace.",[177,199,200,203],{},[192,201,202],{},"Nucleus access token",[192,204,205],{},"Day-to-day memory, CLI, SDK, MCP, and Codex calls for one Nucleus.",[159,207,208],{},"Prefer Nucleus access tokens for agent hosts. Use workspace keys only for trusted setup flows.",[163,210,212],{"id":211},"bearer-token","Bearer token",[214,215,220],"pre",{"className":216,"code":217,"language":218,"meta":219,"style":219},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","Authorization: Bearer \u003CNEUTRON_API_TOKEN>\n","http","",[221,222,223],"code",{"__ignoreMap":219},[224,225,228],"span",{"class":226,"line":227},"line",1,[224,229,217],{},[159,231,232],{},"Keep tokens in server-side environment variables or a managed secret store. Never expose a Neutron AI token in browser code, mobile apps, public repositories, logs, or analytics events.",[163,234,236],{"id":235},"environment-variables","Environment variables",[214,238,242],{"className":239,"code":240,"language":241,"meta":219,"style":219},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","NEUTRON_API_URL=\"https:\u002F\u002Fneutronai.dev\u002Fapi\"\nNEUTRON_API_TOKEN=\"your_nucleus_access_token\"\nNEUTRON_NUCLEUS_ID=\"your_nucleus_id\"\n","bash",[221,243,244,264,279],{"__ignoreMap":219},[224,245,246,250,254,257,261],{"class":226,"line":227},[224,247,249],{"class":248},"sTEyZ","NEUTRON_API_URL",[224,251,253],{"class":252},"sMK4o","=",[224,255,256],{"class":252},"\"",[224,258,260],{"class":259},"sfazB","https:\u002F\u002Fneutronai.dev\u002Fapi",[224,262,263],{"class":252},"\"\n",[224,265,267,270,272,274,277],{"class":226,"line":266},2,[224,268,269],{"class":248},"NEUTRON_API_TOKEN",[224,271,253],{"class":252},[224,273,256],{"class":252},[224,275,276],{"class":259},"your_nucleus_access_token",[224,278,263],{"class":252},[224,280,282,285,287,289,292],{"class":226,"line":281},3,[224,283,284],{"class":248},"NEUTRON_NUCLEUS_ID",[224,286,253],{"class":252},[224,288,256],{"class":252},[224,290,291],{"class":259},"your_nucleus_id",[224,293,263],{"class":252},[163,295,297],{"id":296},"tenant-and-scope-ownership","Tenant and scope ownership",[159,299,300,301,304,305,308,309,312,313,304,315,317],{},"Your platform is responsible for mapping users, workspaces, projects, and agents to stable Neutron AI ",[221,302,303],{},"nucleusId"," and ",[221,306,307],{},"scopeId"," values. ",[221,310,311],{},"tenantId"," remains a legacy alias for memory APIs. If both ",[221,314,311],{},[221,316,303],{}," are supplied, they must match.",[159,319,320],{},"Recommended scope examples:",[322,323,324,330,335,340,345,350],"ul",{},[325,326,327],"li",{},[221,328,329],{},"$NEUTRON_SCOPE_ID",[325,331,332],{},[221,333,334],{},"workspace:workspace_456",[325,336,337],{},[221,338,339],{},"project:project_789",[325,341,342],{},[221,343,344],{},"team:team_abc",[325,346,347],{},[221,348,349],{},"agent:support_assistant",[325,351,352],{},[221,353,354],{},"session:session_def",[163,356,358],{"id":357},"token-rotation","Token rotation",[159,360,361],{},"Rotate tokens if they are exposed or no longer needed. During rotation, deploy the new token server-side first, validate traffic, then revoke the old token.",[163,363,365],{"id":364},"client-side-applications","Client-side applications",[159,367,368],{},"Browser and mobile applications should call your backend. Your backend should authenticate the user, authorize the memory scope, and then call Neutron AI with a server-side token.",[370,371,372],"style",{},"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 .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}",{"title":219,"searchDepth":266,"depth":266,"links":374},[375,376,377,378,379,380],{"id":165,"depth":266,"text":166},{"id":211,"depth":266,"text":212},{"id":235,"depth":266,"text":236},{"id":296,"depth":266,"text":297},{"id":357,"depth":266,"text":358},{"id":364,"depth":266,"text":365},"Public authentication and environment guidance for Neutron AI integrations.","md",{},true,{"title":33,"description":381},"Xhltt6VaOtsxVtlFLTOD2_8VDYsedYOBiOUYFVdFCF0",[388,389],{"title":29,"path":30,"stem":31,"children":-1},{"title":42,"path":38,"stem":39,"children":-1},1784317984172]