Create scoped API keys for machines, automation, and operators.
API keys belong to an organization and carry explicit permissions. Use separate keys for agent ingestion, policy delivery, evaluators, CI automation, and administrative scripts.
Create and rotate a key
Dashboard
CLI
Go to Administration → Keys, select new key, and enter a workload name.
Choose a permission set and adjust individual permissions only when the preset is insufficient.
Create the key and copy its one-time secret immediately.
Open the key later to update grants, disable it, or regenerate the secret.
The creation drawer is where you choose the narrowest grants required by the workload.After creation, the Keys page shows the persistent metadata and management actions. The one-time secret is not shown again.Use this list to review grants regularly and disable keys that no longer map to an active workload.
To run Jev policies through FailproofAI Cloud, select the machine key preset. It adds jev:evaluate to both permissions above. Cloud Jev cannot run with a key that lacks it.Key secrets are shown when created or regenerated. Store them in a secret manager and rotate them without reusing an operator’s interactive credentials.
Permission catalog
Area
Permissions
Events
events:add, events:read
Keys
keys:create, keys:read, keys:disable, keys:regenerate; keys:update is human-session only
jev:evaluate (requires events:add and policies:pull)
orgs:admin is reserved for the instance operator and cannot be granted to an organization key or ordinary member. Retired incidents:* and alerts:ack tokens are accepted for compatibility and normalize to current issues:* permissions.Builtin permission sets are read-only, standard, and admin. standard adds evaluation triggering, query execution, issue response, and assistant use to read permissions. Key creation strips human-only grants even when a permission set contains them.
Instance-scoped keys can select an organization with the X-AgentEye-Org header. Set it explicitly on multi-organization deployments; omission may select the default organization.
Was this page helpful?
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Failproof AI","description":"Trace agent behavior, find failures with audits, and prevent repeat failures with deployed policies.","colors":{"primary":"#c92251","light":"#e4587d","dark":"#e4587d"},"logo":{"light":"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/logo/Failproof_AI_logo_light.png?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=5231ac600a18d7ad299834e4a880f6e0","dark":"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/logo/Failproof_AI_logo.png?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=3f0e8fc7951c3550b7fdeabbca03daff","href":"https://befailproof.ai"},"favicon":"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/favicon.ico?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=ef7e5e9c419deaf5a2298f5ef6d5929f","api":{"openapi":"reference/openapi.json","playground":{"display":"simple"},"examples":{"languages":["curl","python","javascript"]}},"navbar":{"links":[{"icon":"discord","href":"https://discord.befailproof.ai","label":""},{"icon":"reddit","href":"https://www.reddit.com/r/failproofai/","label":""},{"icon":"x-twitter","href":"https://x.com/failproofai","label":""},{"icon":"github","href":"https://github.com/FailproofAI/failproofai","label":"⭐ 1.5k"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.befailproof.ai"}},"footer":{"socials":{"github":"https://github.com/FailproofAI/failproofai","x":"https://x.com/failproofai"}},"search":{"prompt":"Search Failproof AI docs"},"seo":{"indexing":"navigable"},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Support","icon":"mail","href":"mailto:support@befailproof.ai"}]},"languages":[{"language":"en","href":""},{"language":"zh","href":"zh"},{"language":"ja","href":"ja"},{"language":"ko","href":"ko"},{"language":"es","href":"es"},{"language":"pt-BR","href":"pt-br"},{"language":"de","href":"de"},{"language":"fr","href":"fr"},{"language":"ru","href":"ru"},{"language":"hi","href":"hi"},{"language":"tr","href":"tr"},{"language":"vi","href":"vi"},{"language":"it","href":"it"},{"language":"ar","href":"ar"},{"language":"he","href":"he"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"exosphere","hasAudioNarration":false,"actualSubdomain":"exosphere","customDomains":["docs.befailproof.ai"],"gitSource":{"type":"github","owner":"failproofai","repo":"failproofai","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6af7199f9a8829f8111dfce3","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"en","tag":"Integrations and reference","count":130},{"language":"en","tag":"HTTP API","count":109},{"language":"en","tag":"Trace Agents","count":18},{"language":"en","tag":"Audits","count":18},{"language":"en","tag":"Find failures","count":17},{"language":"ar","tag":"Trace Agents","count":17},{"language":"de","tag":"Trace Agents","count":17},{"language":"es","tag":"Trace Agents","count":17},{"language":"fr","tag":"Trace Agents","count":17},{"language":"he","tag":"Trace Agents","count":17},{"language":"hi","tag":"Trace Agents","count":17},{"language":"it","tag":"Trace Agents","count":17},{"language":"ja","tag":"Trace Agents","count":17},{"language":"ko","tag":"Trace Agents","count":17},{"language":"pt-BR","tag":"Trace Agents","count":17},{"language":"ru","tag":"Trace Agents","count":17},{"language":"tr","tag":"Trace Agents","count":17},{"language":"vi","tag":"Trace Agents","count":17},{"language":"zh","tag":"Trace Agents","count":17},{"language":"en","tag":"Issues","count":15},{"language":"en","tag":"Events","count":14},{"language":"ar","tag":"Find failures","count":14},{"language":"de","tag":"Find failures","count":14},{"language":"es","tag":"Find failures","count":14},{"language":"fr","tag":"Find failures","count":14},{"language":"he","tag":"Find failures","count":14},{"language":"hi","tag":"Find failures","count":14},{"language":"it","tag":"Find failures","count":14},{"language":"ja","tag":"Find failures","count":14},{"language":"ko","tag":"Find failures","count":14},{"language":"pt-BR","tag":"Find failures","count":14},{"language":"ru","tag":"Find failures","count":14},{"language":"tr","tag":"Find failures","count":14},{"language":"vi","tag":"Find failures","count":14},{"language":"zh","tag":"Find failures","count":14},{"language":"en","tag":"Start","count":13},{"language":"en","tag":"Start here","count":13},{"language":"ar","tag":"Integrations and reference","count":13},{"language":"de","tag":"Integrations and reference","count":13},{"language":"es","tag":"Integrations and reference","count":13},{"language":"fr","tag":"Integrations and reference","count":13},{"language":"he","tag":"Integrations and reference","count":13},{"language":"hi","tag":"Integrations and reference","count":13},{"language":"it","tag":"Integrations and reference","count":13},{"language":"ja","tag":"Integrations and reference","count":13},{"language":"ko","tag":"Integrations and reference","count":13},{"language":"pt-BR","tag":"Integrations and reference","count":13},{"language":"ru","tag":"Integrations and reference","count":13},{"language":"tr","tag":"Integrations and reference","count":13},{"language":"vi","tag":"Integrations and reference","count":13},{"language":"zh","tag":"Integrations and reference","count":13},{"language":"ar","tag":"Start","count":12},{"language":"ar","tag":"Start here","count":12},{"language":"de","tag":"Start","count":12},{"language":"de","tag":"Start here","count":12},{"language":"es","tag":"Start","count":12},{"language":"es","tag":"Start here","count":12},{"language":"fr","tag":"Start","count":12},{"language":"fr","tag":"Start here","count":12},{"language":"he","tag":"Start","count":12},{"language":"he","tag":"Start here","count":12},{"language":"hi","tag":"Start","count":12},{"language":"hi","tag":"Start here","count":12},{"language":"it","tag":"Start","count":12},{"language":"it","tag":"Start here","count":12},{"language":"ja","tag":"Start","count":12},{"language":"ja","tag":"Start here","count":12},{"language":"ko","tag":"Start","count":12},{"language":"ko","tag":"Start here","count":12},{"language":"pt-BR","tag":"Start","count":12},{"language":"pt-BR","tag":"Start here","count":12},{"language":"ru","tag":"Start","count":12},{"language":"ru","tag":"Start here","count":12},{"language":"tr","tag":"Start","count":12},{"language":"tr","tag":"Start here","count":12},{"language":"vi","tag":"Start","count":12},{"language":"vi","tag":"Start here","count":12},{"language":"zh","tag":"Start","count":12},{"language":"zh","tag":"Start here","count":12},{"language":"en","tag":"Understand every run","count":11},{"language":"ar","tag":"Understand every run","count":11},{"language":"de","tag":"Understand every run","count":11},{"language":"es","tag":"Understand every run","count":11},{"language":"fr","tag":"Understand every run","count":11},{"language":"he","tag":"Understand every run","count":11},{"language":"hi","tag":"Understand every run","count":11},{"language":"it","tag":"Understand every run","count":11},{"language":"ja","tag":"Understand every run","count":11},{"language":"ko","tag":"Understand every run","count":11},{"language":"pt-BR","tag":"Understand every run","count":11},{"language":"ru","tag":"Understand every run","count":11},{"language":"tr","tag":"Understand every run","count":11},{"language":"vi","tag":"Understand every run","count":11},{"language":"zh","tag":"Understand every run","count":11},{"language":"ar","tag":"Find and manage failures","count":9},{"language":"de","tag":"Find and manage failures","count":9},{"language":"es","tag":"Find and manage failures","count":9},{"language":"fr","tag":"Find and manage failures","count":9},{"language":"he","tag":"Find and manage failures","count":9},{"language":"hi","tag":"Find and manage failures","count":9},{"language":"it","tag":"Find and manage failures","count":9},{"language":"ja","tag":"Find and manage failures","count":9},{"language":"ko","tag":"Find and manage failures","count":9},{"language":"pt-BR","tag":"Find and manage failures","count":9},{"language":"ru","tag":"Find and manage failures","count":9},{"language":"tr","tag":"Find and manage failures","count":9},{"language":"vi","tag":"Find and manage failures","count":9},{"language":"zh","tag":"Find and manage failures","count":9},{"language":"ar","tag":"Prevent failures","count":8},{"language":"de","tag":"Prevent failures","count":8},{"language":"es","tag":"Prevent failures","count":8},{"language":"fr","tag":"Prevent failures","count":8},{"language":"he","tag":"Prevent failures","count":8},{"language":"hi","tag":"Prevent failures","count":8},{"language":"it","tag":"Prevent failures","count":8},{"language":"ja","tag":"Prevent failures","count":8},{"language":"ko","tag":"Prevent failures","count":8},{"language":"pt-BR","tag":"Prevent failures","count":8},{"language":"ru","tag":"Prevent failures","count":8},{"language":"tr","tag":"Prevent failures","count":8},{"language":"vi","tag":"Prevent failures","count":8},{"language":"zh","tag":"Prevent failures","count":8},{"language":"ar","tag":"Reference","count":7},{"language":"de","tag":"Reference","count":7},{"language":"es","tag":"Reference","count":7},{"language":"fr","tag":"Reference","count":7},{"language":"he","tag":"Reference","count":7},{"language":"hi","tag":"Reference","count":7},{"language":"it","tag":"Reference","count":7},{"language":"ja","tag":"Reference","count":7},{"language":"ko","tag":"Reference","count":7},{"language":"pt-BR","tag":"Reference","count":7},{"language":"ru","tag":"Reference","count":7},{"language":"tr","tag":"Reference","count":7},{"language":"vi","tag":"Reference","count":7},{"language":"zh","tag":"Reference","count":7},{"language":"ar","tag":"Connect your agents","count":6},{"language":"de","tag":"Connect your agents","count":6},{"language":"es","tag":"Connect your agents","count":6},{"language":"fr","tag":"Connect your agents","count":6},{"language":"he","tag":"Connect your agents","count":6},{"language":"hi","tag":"Connect your agents","count":6},{"language":"it","tag":"Connect your agents","count":6},{"language":"ja","tag":"Connect your agents","count":6},{"language":"ko","tag":"Connect your agents","count":6},{"language":"pt-BR","tag":"Connect your agents","count":6},{"language":"ru","tag":"Connect your agents","count":6},{"language":"tr","tag":"Connect your agents","count":6},{"language":"vi","tag":"Connect your agents","count":6},{"language":"zh","tag":"Connect your agents","count":6}]},"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":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":":root{--fpai-pink: #c92251}.dark{--fpai-pink: #e4587d}h1,h2,h3{letter-spacing:-0.025em}#content blockquote{position:relative;margin:1.5rem 0;padding:1.25rem 1.5rem 1.25rem 3.75rem!important;border-left:4px solid var(--fpai-pink)!important;border-radius:0 14px 14px 0;background:#f3f4f6!important;color:inherit!important}#content blockquote::before{content:\"“\";position:absolute;top:0.35rem;left:1rem;color:var(--fpai-pink);font-size:3rem;font-weight:700;line-height:1}#content blockquote p:first-child{margin-top:0}#content blockquote p:last-child{margin-bottom:0}.dark #content blockquote{background:rgba(148, 163, 184, 0.12)!important}.navbar-link a[href=\"https://discord.befailproof.ai\"],.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"],.navbar-link a[href=\"https://x.com/failproofai\"],.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"],#topbar-cta-button a[href=\"https://app.befailproof.ai\"]{position:relative}.navbar-link a[href=\"https://discord.befailproof.ai\"]::after,.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]::after,.navbar-link a[href=\"https://x.com/failproofai\"]::after,.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]::after,#topbar-cta-button a[href=\"https://app.befailproof.ai\"]::after{position:absolute;top:calc(100% + 0.5rem);left:50%;z-index:50;padding:0.35rem 0.55rem;border-radius:0.4rem;background:#111827;color:#fff;font-size:0.75rem;font-weight:500;line-height:1;opacity:0;pointer-events:none;transform:translate(-50%, -0.2rem);transition:opacity 120ms ease, transform 120ms ease}.navbar-link a[href=\"https://discord.befailproof.ai\"]::after{content:\"Join the community\"}.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]::after{content:\"Join r/failproofai\"}.navbar-link a[href=\"https://x.com/failproofai\"]::after{content:\"Follow launches\"}.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]::after{content:\"Star us!\"}#topbar-cta-button a[href=\"https://app.befailproof.ai\"]::after{content:\"Go to Failproof\"}.navbar-link a[href=\"https://discord.befailproof.ai\"]:hover::after,.navbar-link a[href=\"https://discord.befailproof.ai\"]:focus-visible::after,.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]:hover::after,.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]:focus-visible::after,.navbar-link a[href=\"https://x.com/failproofai\"]:hover::after,.navbar-link a[href=\"https://x.com/failproofai\"]:focus-visible::after,.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]:hover::after,.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]:focus-visible::after,#topbar-cta-button a[href=\"https://app.befailproof.ai\"]:hover::after,#topbar-cta-button a[href=\"https://app.befailproof.ai\"]:focus-visible::after{opacity:1;transform:translate(-50%, 0)}img[src^=\"/images/frameworks/\"]{opacity:0.78}.dark img[src^=\"/images/frameworks/\"]{filter:invert(1);opacity:0.7}"}],"page":{"pagePath":"admin/keys-and-permissions","slug":"/admin/keys-and-permissions","pageMetadata":{"title":"Keys and permissions","description":"Create scoped API keys for machines, automation, and operators.","icon":"key-round","href":"/admin/keys-and-permissions"},"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: \"Create scoped API keys for machines, automation, and operators.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,OptimizedImage,Tab,Table,Tabs,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`API keys belong to an organization and carry explicit permissions. Use separate keys for agent ingestion, policy delivery, evaluators, CI automation, and administrative scripts.`}),`\n`,_jsx(Heading,{level:`2`,id:`create-and-rotate-a-key`,children:`Create and rotate a key`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Dashboard`,id:`dashboard`,children:[_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Go to `,_jsx(_components.strong,{children:`Administration → Keys`}),`, select `,_jsx(_components.strong,{children:`new key`}),`, and enter a workload name.`]}),`\n`,_jsx(_components.li,{children:`Choose a permission set and adjust individual permissions only when the preset is insufficient.`}),`\n`,_jsx(_components.li,{children:`Create the key and copy its one-time secret immediately.`}),`\n`,_jsx(_components.li,{children:`Open the key later to update grants, disable it, or regenerate the secret.`}),`\n`]}),_jsx(_components.p,{children:`The creation drawer is where you choose the narrowest grants required by the workload.`}),_jsx(OptimizedImage,{src:`https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/key-create.png?fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=a428bdae79f837471acb66414ff6455b`,alt:`The new API key drawer with permission presets and individual grants.`,\"data-og-width\":`2940`,width:`2940`,\"data-og-height\":`1604`,height:`1604`,\"data-path\":`images/dashboard/key-create.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/key-create.png?w=280\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=494089c9a6f0ac78986c2031aa00d438 280w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/key-create.png?w=560\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=64fe70e98b11c6b1bc28c7c4285a3030 560w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/key-create.png?w=840\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=1c41c10311c90643c4178207a061feef 840w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/key-create.png?w=1100\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=7c89d404ff37caaccebd569728aeee4e 1100w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/key-create.png?w=1650\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=39c56366e91e60df37115dad8a3fca05 1650w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/key-create.png?w=2500\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=0dc4d424d1d7597987eaa5d1108619a3 2500w`}),_jsx(_components.p,{children:`After creation, the Keys page shows the persistent metadata and management actions. The one-time secret is not shown again.`}),_jsx(OptimizedImage,{src:`https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/api-keys.png?fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=9286c82c5b34ab057715817d434927db`,alt:`The API Keys page showing key permissions, creation time, and regenerate and disable actions.`,\"data-og-width\":`3200`,width:`3200`,\"data-og-height\":`2000`,height:`2000`,\"data-path\":`images/dashboard/api-keys.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/api-keys.png?w=280\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=e79a8452fdf99d86ca805620a2473455 280w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/api-keys.png?w=560\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=4b5f715a7a3c59f1cb8d3962fc94c9c8 560w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/api-keys.png?w=840\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=7022a5d70e6669877cd373e6aafd0320 840w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/api-keys.png?w=1100\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=6226f125826c5ac707ffb1b4452c99f7 1100w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/api-keys.png?w=1650\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=84f72631369600981f4ccb60d5f8c8a8 1650w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/api-keys.png?w=2500\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=d8ffd1ed5a9e9e11e94de34c2a616b7e 2500w`}),_jsx(_components.p,{children:`Use this list to review grants regularly and disable keys that no longer map to an active workload.`})]}),_jsxs(Tab,{title:`CLI`,id:`cli`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`fp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` keys`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` create`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` production-agents`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` events:add`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` policies:pull`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`fp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` keys`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` show`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` production-agents`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`fp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` keys`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` update`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` production-agents`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` events:read`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`fp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` keys`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` regenerate`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` production-agents`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --yes`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`fp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` keys`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` disable`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` production-agents`})]}),`\n`]})})}),_jsx(_components.p,{children:`Redirect or capture create/regenerate output securely; the secret is returned once.`})]})]}),`\n`,_jsx(_components.p,{children:`The two permissions required by a connected Failproof AI machine are independent:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`events:add`}),` sends events and session data.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`policies:pull`}),` retrieves assigned policy deployments.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`To run `,_jsx(_components.a,{href:`/policies/jev`,children:`Jev policies through FailproofAI Cloud`}),`, select the `,_jsx(_components.strong,{children:`machine`}),` key preset. It adds `,_jsx(_components.code,{children:`jev:evaluate`}),` to both permissions above. Cloud Jev cannot run with a key that lacks it.`]}),`\n`,_jsx(_components.p,{children:`Key secrets are shown when created or regenerated. Store them in a secret manager and rotate them without reusing an operator’s interactive credentials.`}),`\n`,_jsx(Heading,{level:`2`,id:`permission-catalog`,children:`Permission catalog`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Area`}),_jsx(_components.th,{children:`Permissions`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Events`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`events:add`}),`, `,_jsx(_components.code,{children:`events:read`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Keys`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`keys:create`}),`, `,_jsx(_components.code,{children:`keys:read`}),`, `,_jsx(_components.code,{children:`keys:disable`}),`, `,_jsx(_components.code,{children:`keys:regenerate`}),`; `,_jsx(_components.code,{children:`keys:update`}),` is human-session only`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Users`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`users:create`}),`, `,_jsx(_components.code,{children:`users:read`}),`, `,_jsx(_components.code,{children:`users:update`}),`, `,_jsx(_components.code,{children:`users:delete`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Evaluations`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`evaluations:read`}),`, `,_jsx(_components.code,{children:`evaluations:trigger`}),`, `,_jsx(_components.code,{children:`evaluations:run`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Dashboards`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`dashboards:read`}),`, `,_jsx(_components.code,{children:`dashboards:write`}),`, `,_jsx(_components.code,{children:`dashboards:delete`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Queries`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`queries:read`}),`, `,_jsx(_components.code,{children:`queries:write`}),`, `,_jsx(_components.code,{children:`queries:delete`}),`, `,_jsx(_components.code,{children:`queries:run`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Assistant`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`agent:use`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Settings`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`settings:read`}),`, `,_jsx(_components.code,{children:`settings:write`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Alerts`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`alerts:read`}),`, `,_jsx(_components.code,{children:`alerts:write`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Issues`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`issues:read`}),`, `,_jsx(_components.code,{children:`issues:create`}),`, `,_jsx(_components.code,{children:`issues:close`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Audits`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`audits:read`}),`, `,_jsx(_components.code,{children:`audits:write`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Policies`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`policies:read`}),`, `,_jsx(_components.code,{children:`policies:write`}),`, `,_jsx(_components.code,{children:`policies:pull`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Usage`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`usage:read`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Jev`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`jev:evaluate`}),` (requires `,_jsx(_components.code,{children:`events:add`}),` and `,_jsx(_components.code,{children:`policies:pull`}),`)`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`orgs:admin`}),` is reserved for the instance operator and cannot be granted to an organization key or ordinary member. Retired `,_jsx(_components.code,{children:`incidents:*`}),` and `,_jsx(_components.code,{children:`alerts:ack`}),` tokens are accepted for compatibility and normalize to current `,_jsx(_components.code,{children:`issues:*`}),` permissions.`]}),`\n`,_jsxs(_components.p,{children:[`Builtin permission sets are `,_jsx(_components.code,{children:`read-only`}),`, `,_jsx(_components.code,{children:`standard`}),`, and `,_jsx(_components.code,{children:`admin`}),`. `,_jsx(_components.code,{children:`standard`}),` adds evaluation triggering, query execution, issue response, and assistant use to read permissions. Key creation strips human-only grants even when a permission set contains them.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Instance-scoped keys can select an organization with the `,_jsx(_components.code,{children:`X-AgentEye-Org`}),` header. Set it explicitly on multi-organization deployments; omission may select the default organization.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Keys and permissions","description":"Create scoped API keys for machines, automation, and operators.","icon":"key-round","href":"/admin/keys-and-permissions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Create and rotate a key","slug":"create-and-rotate-a-key","depth":2,"children":[]},{"title":"Permission catalog","slug":"permission-catalog","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/exosphere/86fd84cc0563b6f3/stars.js","/_mintlify/custom/exosphere/3e9809a158d7fc0b/reo.js"],"subdomain":"exosphere","siteName":"Failproof AI","title":"Keys and permissions - Failproof AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/admin/keys-and-permissions","matchLevel":0},"zh":{"href":"/zh/admin/keys-and-permissions","matchLevel":1},"ja":{"href":"/ja/admin/keys-and-permissions","matchLevel":1},"ko":{"href":"/ko/admin/keys-and-permissions","matchLevel":1},"es":{"href":"/es/admin/keys-and-permissions","matchLevel":1},"pt-BR":{"href":"/pt-br/admin/keys-and-permissions","matchLevel":1},"de":{"href":"/de/admin/keys-and-permissions","matchLevel":1},"fr":{"href":"/fr/admin/keys-and-permissions","matchLevel":1},"ru":{"href":"/ru/admin/keys-and-permissions","matchLevel":1},"hi":{"href":"/hi/admin/keys-and-permissions","matchLevel":1},"tr":{"href":"/tr/admin/keys-and-permissions","matchLevel":1},"vi":{"href":"/vi/admin/keys-and-permissions","matchLevel":1},"it":{"href":"/it/admin/keys-and-permissions","matchLevel":1},"ar":{"href":"/ar/admin/keys-and-permissions","matchLevel":1},"he":{"href":"/he/admin/keys-and-permissions","matchLevel":1}}},"lastModified":"2026-11-13T13:58:21.481Z","originalFileLocation":"admin/keys-and-permissions.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create scoped API keys for machines, automation, and operators.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Failproof AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_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/exosphere/jZWjNNy57lpILUrG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_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/exosphere/jZWjNNy57lpILUrG/_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/exosphere/jZWjNNy57lpILUrG/_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/exosphere/jZWjNNy57lpILUrG/_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/exosphere/jZWjNNy57lpILUrG/_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/exosphere/jZWjNNy57lpILUrG/_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/exosphere/jZWjNNy57lpILUrG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Keys and permissions - Failproof AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create scoped API keys for machines, automation, and operators.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Failproof AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.befailproof.ai/admin/keys-and-permissions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://exosphere.mintlify.site/_mintlify/api/og/v2?division=Operate+Failproof+AI\u0026amp;title=Keys+and+permissions\u0026amp;description=Create+scoped+API+keys+for+machines%2C+automation%2C+and+operators.\u0026amp;theme=cebdc1f0592da2cd408854e5\u0026amp;signature=27f4f4b8f338a1b1c0b4a659dce9b7ebfe9597605aaa7b9c0f72e20d4dd53c2e\">\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=\"Keys and permissions - Failproof AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create scoped API keys for machines, automation, and operators.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://exosphere.mintlify.site/_mintlify/api/og/v2?division=Operate+Failproof+AI\u0026amp;title=Keys+and+permissions\u0026amp;description=Create+scoped+API+keys+for+machines%2C+automation%2C+and+operators.\u0026amp;theme=cebdc1f0592da2cd408854e5\u0026amp;signature=27f4f4b8f338a1b1c0b4a659dce9b7ebfe9597605aaa7b9c0f72e20d4dd53c2e\">\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/exosphere/jZWjNNy57lpILUrG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Failproof AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#c92251\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.befailproof.ai/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/admin/keys-and-permissions.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.befailproof.ai/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.befailproof.ai/zh/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.befailproof.ai/ja/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.befailproof.ai/ko/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.befailproof.ai/es/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.befailproof.ai/pt-br/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.befailproof.ai/de/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.befailproof.ai/fr/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.befailproof.ai/ru/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"hi\" href=\"https://docs.befailproof.ai/hi/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://docs.befailproof.ai/tr/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"vi\" href=\"https://docs.befailproof.ai/vi/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.befailproof.ai/it/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.befailproof.ai/ar/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"he\" href=\"https://docs.befailproof.ai/he/admin/keys-and-permissions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.befailproof.ai/admin/keys-and-permissions\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.befailproof.ai/#organization\",\"name\":\"Failproof AI\",\"url\":\"https://docs.befailproof.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/logo/Failproof_AI_logo_light.png?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=5231ac600a18d7ad299834e4a880f6e0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.befailproof.ai#website\",\"name\":\"Failproof AI\",\"url\":\"https://docs.befailproof.ai\",\"publisher\":{\"@id\":\"https://docs.befailproof.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.befailproof.ai/admin/keys-and-permissions#webpage\",\"url\":\"https://docs.befailproof.ai/admin/keys-and-permissions\",\"name\":\"Keys and permissions\",\"description\":\"Create scoped API keys for machines, automation, and operators.\",\"dateModified\":\"2026-11-13T13:58:21.481Z\",\"isPartOf\":{\"@id\":\"https://docs.befailproof.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.befailproof.ai/admin/keys-and-permissions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.befailproof.ai/admin/keys-and-permissions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Operate Failproof AI\",\"item\":\"https://docs.befailproof.ai/admin/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Keys and permissions\",\"item\":\"https://docs.befailproof.ai/admin/keys-and-permissions\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.befailproof.ai/admin/keys-and-permissions#article\",\"headline\":\"Keys and permissions\",\"name\":\"Keys and permissions\",\"description\":\"Create scoped API keys for machines, automation, and operators.\",\"url\":\"https://docs.befailproof.ai/admin/keys-and-permissions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.befailproof.ai/admin/keys-and-permissions#webpage\"},\"dateModified\":\"2026-11-13T13:58:21.481Z\",\"publisher\":{\"@id\":\"https://docs.befailproof.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.befailproof.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Failproof AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Failproof AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/admin/keys-and-permissions.md","siteName":"Failproof AI","nav":{"global":{"anchors":[{"anchor":"Support","icon":"mail","href":"mailto:support@befailproof.ai"}]},"languages":[{"language":"en","tabs":[{"tab":"Start","icon":"rocket","pages":[{"title":"Start","href":""}]},{"tab":"Trace Agents","icon":"route","pages":[{"title":"Trace Agents","href":"/sessions/overview"}]},{"tab":"Find failures","icon":"scan-search","pages":[{"title":"Find failures","href":"/evaluations/overview"}]},{"tab":"Prevent failures","icon":"shield-check","pages":[{"title":"Prevent failures","href":"/policies/overview"}]},{"tab":"Admin","icon":"settings-2","groups":[{"group":"Operate Failproof AI","pages":[{"title":"Administration","icon":"settings-2","href":"/admin/overview"},{"title":"Usage","description":"Inspect organization consumption and the active billing window.","icon":"chart-no-axes-combined","href":"/admin/usage"},{"title":"Keys and permissions","icon":"key-round","href":"/admin/keys-and-permissions"},{"title":"Users and organizations","description":"Control membership and keep each organization's data and actions scoped.","icon":"users","href":"/admin/users-and-organizations"},{"title":"Settings and security","icon":"lock-keyhole","href":"/admin/settings-and-security"},{"title":"Product analytics","icon":"chart-no-axes-column","href":"/admin/product-analytics"}]}]},{"tab":"Integrations and reference","icon":"braces","pages":[{"title":"Integrations and reference","href":"/reference/overview"}]}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/admin/keys-and-permissions"}]},{"language":"ja","pages":[{"title":"ja","href":"/ja/admin/keys-and-permissions"}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/admin/keys-and-permissions"}]},{"language":"es","pages":[{"title":"es","href":"/es/admin/keys-and-permissions"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-br/admin/keys-and-permissions"}]},{"language":"de","pages":[{"title":"de","href":"/de/admin/keys-and-permissions"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/admin/keys-and-permissions"}]},{"language":"ru","pages":[{"title":"ru","href":"/ru/admin/keys-and-permissions"}]},{"language":"hi","pages":[{"title":"hi","href":"/hi/admin/keys-and-permissions"}]},{"language":"tr","pages":[{"title":"tr","href":"/tr/admin/keys-and-permissions"}]},{"language":"vi","pages":[{"title":"vi","href":"/vi/admin/keys-and-permissions"}]},{"language":"it","pages":[{"title":"it","href":"/it/admin/keys-and-permissions"}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/admin/keys-and-permissions"}]},{"language":"he","pages":[{"title":"he","href":"/he/admin/keys-and-permissions"}]}]},"basePath":"","title":"Keys and permissions - Failproof AI","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-CkI5al_8.js","lightbox-handle-r17bVUz3.js"]}