Mark a variable as secret with {"secret": true, "value": "..."}, as described in Run agents. Orq.ai substitutes the value into instructions and tool headers, then redacts it wherever the run is recorded:
Traces and span attributes: the value is replaced with ***.
Stored response variables: the secret key is removed.
The live response: still contains the rendered value.
A secret variable redacts its value at run time only. A value stored in a schedule payload, a notifier header, or a webhook definition stays readable wherever that resource is readable.
Encrypted with a workspace key (AES-256-GCM): provider, MCP server, SSO, and external knowledge base credentials. A database read alone does not disclose them.
Hashed: API Keys and Management Keys store a SHA-256 hash and a displayable prefix, never the token.
Plain text: schedule payload variables, notifier headers, and webhook signing secrets. Schedule payload variables rely on access control alone; notifier headers are masked on read only when marked {"secret": true}, and webhook signing secrets are always masked on read.
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Orq.ai Documentation","description":"Documentation for Orq.ai, the EU-built control plane for enterprise AI: govern every LLM and MCP call with the AI Gateway, and ship backlog work with the Software Factory.","colors":{"primary":"#027f6b","light":"#00d2b5","dark":"#027f6b"},"logo":{"light":"https://mintcdn.com/orqai/OG_14djpK9Yasgfk/images/Orq_ai_Symbol_Dark.svg?fit=max\u0026auto=format\u0026n=OG_14djpK9Yasgfk\u0026q=85\u0026s=d01651850182afdbc6309808b688d470","dark":"https://mintcdn.com/orqai/BYq_L5I_ZDBWL_Pf/images/Orq_ai_Symbol_Light.svg?fit=max\u0026auto=format\u0026n=BYq_L5I_ZDBWL_Pf\u0026q=85\u0026s=3e372f93174202f20c31d2c045af92b9","href":"/ai-gateway/get-started/introduction"},"favicon":"https://mintcdn.com/orqai/rmwcfFw4PPljHRCz/favicon.svg?fit=max\u0026auto=format\u0026n=rmwcfFw4PPljHRCz\u0026q=85\u0026s=1827beca4e1fb46e074d8bda067f3fb1","api":{"openapi":"openapi.json","examples":{"languages":["curl","typescript","python"]}},"background":{"color":{"light":"#f7f6f5","dark":"#171717"}},"navbar":{"links":[],"primary":{"type":"button","label":"Get Started","href":"https://my.orq.ai/auth/signup"}},"footer":{"socials":{"github":"https://github.com/orq-ai","x":"https://x.com/orq_ai","linkedin":"https://www.linkedin.com/company/orqai","website":"https://orq.ai"}},"seo":{"metatags":{"author":"Orq.ai","og:type":"website","og:site_name":"Orq.ai Documentation","og:locale":"en_US","twitter:card":"summary_large_image","twitter:site":"@orq_ai","twitter:creator":"@orq_ai","viewport":"width=device-width, initial-scale=1.0","robots":"index, follow","language":"English"},"organization":{"id":"https://docs.orq.ai/#organization","name":"Orq.ai","legalName":"Orq.AI Holding B.V.","url":"https://orq.ai","logo":"https://docs.orq.ai/images/Orq_ai_Symbol_Dark.svg","sameAs":["https://github.com/orq-ai","https://x.com/orq_ai","https://www.linkedin.com/company/orqai/"]},"indexing":"all"},"fonts":{"heading":{"family":"ES Klarheit Kurrent Semibold","weight":600,"source":"https://framerusercontent.com/assets/HiovZWjG27S5NQhE8dyeECDMc.woff2","format":"woff2"},"body":{"family":"Inter","weight":400,"source":"fonts/inter-latin-400-normal.woff2","format":"woff2"}},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":true},"contextual":{"options":["copy","download-spec","chatgpt","claude","view"],"display":"header"},"interaction":{"drilldown":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"orqai","hasAudioNarration":false,"actualSubdomain":"orqai","customDomains":["docs.orq.ai"],"gitSource":{"type":"github","owner":"orq-ai","repo":"orquesta-web","deployBranch":"main","contentDirectory":"documentation/mintlify","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aec613bada4d37850e27e55","collectionId":"97d33066-b9a1-4280-87e1-bbb0adeceadf","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aec613bada4d37850e27e55"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aec613bada4d37850e27e55","clientVersion":"0.0.4071","searchFilterCounts":[{"language":"default","tag":"API Reference","count":404},{"language":"default","tag":"Platform APIs","count":258},{"language":"default","tag":"Integrations","count":93},{"language":"default","tag":"Orq SDK","count":70},{"language":"default","tag":"AI Gateway","count":69},{"language":"default","tag":"Management APIs","count":68},{"language":"default","tag":"SDK Reference","count":67},{"language":"default","tag":"Cookbooks","count":34},{"language":"default","tag":"Model Providers","count":31},{"language":"default","tag":"Frameworks \u0026 SDKs","count":30}],"searchSettings":{"maxResults":15}},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"email":"support@orq.ai","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"llms-txt-v2","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":"vite-origin","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":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":".nav-anchor img{border-radius:50%}.ig-root{scroll-margin-top:6rem}.ig-search{width:100%;padding:10px 14px 10px 38px;border-radius:8px;border:1px solid rgba(0, 0, 0, 0.15);font-size:14px;outline:none;margin-bottom:20px;background:transparent;box-sizing:border-box;background-image:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='16' height='16' fill='none' viewBox='0 0 24 24'%3E%3Cpath stroke='%23999' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='m21 21-4.35-4.35M17 11A6 6 0 1 1 5 11a6 6 0 0 1 12 0Z'/%3E%3C/svg%3E\");background-repeat:no-repeat;background-position:12px center}.dark .ig-search{border-color:rgba(255, 255, 255, 0.15)}.ig-search:focus{border-color:#027f6b}.ig-tabs{display:flex;border-bottom:1px solid rgba(0, 0, 0, 0.1);margin-bottom:20px;gap:0}.dark .ig-tabs{border-bottom-color:rgba(255, 255, 255, 0.1)}.ig-tab{padding:8px 16px;background:none;border:none;border-bottom:2px solid transparent;margin-bottom:-1px;cursor:pointer;font-size:14px;font-weight:500;color:#888;white-space:nowrap}.ig-tab:hover{color:#027f6b}.dark .ig-tab:hover{color:#677F78}.ig-tab-active{border-bottom-color:#027f6b!important;color:#027f6b!important}.dark .ig-tab-active{border-bottom-color:#677F78!important;color:#677F78!important}.ig-grid{display:grid;grid-template-columns:repeat(4, 1fr);gap:6px}@media (max-width: 768px){.ig-grid{grid-template-columns:repeat(3, 1fr)}}@media (max-width: 480px){.ig-grid{grid-template-columns:repeat(2, 1fr)}}.ig-card{display:flex;align-items:center;gap:8px;padding:10px 14px;border:1px solid rgba(0, 0, 0, 0.1);border-radius:6px;text-decoration:none!important;color:inherit!important;font-size:14px;font-weight:500;transition:background 0.12s, border-color 0.12s}.ig-card:hover{background:rgba(2, 127, 107, 0.05);border-color:rgba(2, 127, 107, 0.25)}.dark .ig-card{border-color:rgba(255, 255, 255, 0.1)}.dark .ig-card:hover{background:rgba(103, 127, 120, 0.1);border-color:rgba(103, 127, 120, 0.3)}.ig-card-icon{width:20px;height:20px;object-fit:contain;flex-shrink:0}.ig-tab-count{display:inline-flex;align-items:center;justify-content:center;margin-left:6px;padding:0 5px;min-width:18px;height:18px;border-radius:9px;font-size:11px;font-weight:600;background:rgba(0, 0, 0, 0.08);color:inherit}.dark .ig-tab-count{background:rgba(255, 255, 255, 0.12)}.ig-tab-active .ig-tab-count{background:rgba(2, 127, 107, 0.15)}.dark .ig-tab-active .ig-tab-count{background:rgba(103, 127, 120, 0.25)}.ig-empty{text-align:center;padding:48px 24px;color:#999;font-size:14px;grid-column:1 / -1}kbd.key,kbd.key *{color:#fff!important}kbd.key{background:#242424;border-radius:5px;padding:2px 8px;font-size:0.85em;display:inline-flex;align-items:center;gap:6px;border:1px solid #3a3a3a;font-family:inherit;white-space:nowrap}#sidebar-content .flex-1:has(>svg.flex-shrink-0){flex:none!important}#sidebar-content{width:16rem!important;min-width:16rem!important}@media (min-width: 1024px){.lg\\:pl-56{padding-left:16rem!important}}.topbar-right-container nav[aria-label=\"Main\"] .navbar-link a,.topbar-right-container nav[aria-label=\"Main\"] .navbar-link a:hover{background-color:transparent!important}@media (min-width: 1024px){.topbar-right-container nav[aria-label=\"Main\"] ul{gap:1rem!important}.topbar-right-container nav[aria-label=\"Main\"] .navbar-link a{padding-left:0!important;padding-right:0!important}#page-title{font-size:2rem!important;line-height:1.2!important}}.nav-tabs-item:has(a[href^=\"/reference\"]){display:none!important}#navbar .nav-tabs-item[href=\"/ai-studio/integrations/overview\"]{position:relative}#navbar .nav-tabs-item[href=\"/ai-studio/integrations/overview\"]::before{content:'';position:absolute;top:50%;left:-12px;transform:translateY(-50%);height:55%;width:1px;background:rgba(0, 0, 0, 0.15)}.dark #navbar .nav-tabs-item[href=\"/ai-studio/integrations/overview\"]::before{background:rgba(255, 255, 255, 0.15)}@media (min-width: 1280px){#content-container{padding-left:3rem!important;padding-right:2rem!important}#content-side-layout{max-width:20rem!important}#content-area{width:calc(100% - 20rem)!important}}.md-export-list{display:none}@font-face{font-family:'Inter';src:url('/fonts/inter-latin-400-normal.woff2') format('woff2');font-style:normal;font-weight:400;font-display:optional}"}],"page":{"pagePath":"ai-studio/organization/secrets","slug":"/ai-studio/organization/secrets","pageMetadata":{"title":"Secrets management","sidebarTitle":"Secrets","description":"Where Orq.ai stores API Keys, provider credentials, secret variables, and signing secrets, who can read each one, and how to rotate it.","href":"/ai-studio/organization/secrets"},"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: \"Where Orq.ai stores API Keys, provider credentials, secret variables, and signing secrets, who can read each one, and how to rotate it.\"\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`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Orq.ai`}),` stores, exposes, and rotates each kind of secret differently. The table below maps each one and links to the page that owns it.`]}),`\n`,_jsx(Heading,{level:`2`,id:`where-each-secret-lives`,children:`Where each secret lives`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Secret`}),_jsx(_components.th,{children:`Stored as`}),_jsx(_components.th,{children:`Readable by`}),_jsx(_components.th,{children:`Rotation`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/ai-studio/organization/api-keys`,children:_jsx(_components.strong,{children:`API Keys`})}),` (`,_jsx(_components.code,{children:`sk-orq-…`}),`)`]}),_jsx(_components.td,{children:`SHA-256 hash and displayable prefix`}),_jsx(_components.td,{children:`Create response only`}),_jsx(_components.td,{children:`Create a replacement, then revoke the old`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/ai-studio/organization/management-keys`,children:_jsx(_components.strong,{children:`Management Keys`})})}),_jsx(_components.td,{children:`SHA-256 hash and displayable prefix`}),_jsx(_components.td,{children:`Create response only; admin-only page`}),_jsx(_components.td,{children:`Create a replacement, then revoke the old`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/ai-gateway/providers-overview`,children:`Provider keys`}),` (BYOK)`]}),_jsx(_components.td,{children:`Encrypted with a workspace key`}),_jsx(_components.td,{children:`Never returned; masked on read`}),_jsx(_components.td,{children:`Update the key on the provider panel`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/ai-studio/ai-engineering/run-agents`,children:`Secret variables`}),` in runs and `,_jsx(_components.a,{href:`/ai-studio/ai-engineering/schedule-agents`,children:`schedules`})]}),_jsx(_components.td,{children:`Plain text in the schedule payload`}),_jsx(_components.td,{children:`Anyone who can read the schedule`}),_jsx(_components.td,{children:`Store the payload again`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/ai-studio/observability/notifiers#secret-headers`,children:`Notifier webhook headers`})}),_jsx(_components.td,{children:`Plain text`}),_jsxs(_components.td,{children:[`Returned empty only when marked `,_jsx(_components.code,{children:`{\"secret\": true}`})]}),_jsx(_components.td,{children:`Update the header`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/ai-studio/organization/webhooks`,children:`Webhook signing secret`})}),_jsx(_components.td,{children:`Plain text`}),_jsx(_components.td,{children:`Create response only; masked on read`}),_jsx(_components.td,{children:`Generate a new secret, then update the webhook`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/ai-gateway/mcp-portal/mcp-servers`,children:`MCP server credentials`})}),_jsx(_components.td,{children:`Encrypted with a workspace key`}),_jsx(_components.td,{children:`Never returned; masked preview`}),_jsx(_components.td,{children:`Update in the server settings`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/ai-studio/organization/sso`,children:`SSO credentials`})}),_jsx(_components.td,{children:`Encrypted with a workspace key`}),_jsx(_components.td,{children:`Never returned`}),_jsx(_components.td,{children:`Re-enter the credential`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/ai-studio/ai-engineering/external-knowledge-bases`,children:`External knowledge base key`})}),_jsx(_components.td,{children:`Encrypted with a workspace key`}),_jsx(_components.td,{children:`Never returned`}),_jsx(_components.td,{children:`Update the key`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`keeping-secret-variables-out-of-traces`,children:`Keeping secret variables out of traces`}),`\n`,_jsxs(_components.p,{children:[`Mark a variable as secret with `,_jsx(_components.code,{children:`{\"secret\": true, \"value\": \"...\"}`}),`, as described in `,_jsx(_components.a,{href:`/ai-studio/ai-engineering/run-agents`,children:`Run agents`}),`. `,_jsx(_components.strong,{children:`Orq.ai`}),` substitutes the value into instructions and tool headers, then redacts it wherever the run is recorded:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Traces and span attributes: the value is replaced with `,_jsx(_components.code,{children:`***`}),`.`]}),`\n`,_jsx(_components.li,{children:`Stored response variables: the secret key is removed.`}),`\n`,_jsx(_components.li,{children:`The live response: still contains the rendered value.`}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`A secret variable redacts its value at run time only. A value stored in a schedule payload, a notifier header, or a webhook definition stays readable wherever that resource is readable.`})}),`\n`,_jsxs(_components.p,{children:[`For content-level masking of request and response bodies, see `,_jsx(_components.a,{href:`/ai-gateway/features/security`,children:`Mask sensitive content in traces`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`encryption-at-rest`,children:`Encryption at rest`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Encrypted with a workspace key`}),` (AES-256-GCM): provider, MCP server, SSO, and external knowledge base credentials. A database read alone does not disclose them.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Hashed`}),`: API Keys and Management Keys store a SHA-256 hash and a displayable prefix, never the token.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Plain text`}),`: schedule payload variables, notifier headers, and webhook signing secrets. Schedule payload variables rely on access control alone; notifier headers are masked on read only when marked `,_jsx(_components.code,{children:`{\"secret\": true}`}),`, and webhook signing secrets are always masked on read.`]}),`\n`]})]})}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":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Secrets management","sidebarTitle":"Secrets","description":"Where Orq.ai stores API Keys, provider credentials, secret variables, and signing secrets, who can read each one, and how to rotate it.","href":"/ai-studio/organization/secrets"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Where each secret lives","slug":"where-each-secret-lives","depth":2,"children":[]},{"title":"Keeping secret variables out of traces","slug":"keeping-secret-variables-out-of-traces","depth":2,"children":[]},{"title":"Encryption at rest","slug":"encryption-at-rest","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/orqai/19ee3574279bbaa0/gtm.js","/_mintlify/custom/orqai/1f1a49b99957b631/commonroom-signals.js"],"subdomain":"orqai","siteName":"Orq.ai Documentation","title":"Secrets management - Orq.ai Documentation","contextualStarterQuestions":[{"_id":"6ac4f5f23c2b860edea6da0c","deploymentId":"68c9bcd7a1b07562da8b036b","questionText":"Who can access my secrets?","status":"active","generatedBy":"contextual","path":"ai-studio/organization/secrets","createdAt":"2026-10-06T13:21:54.983Z","updatedAt":"2026-10-06T13:21:54.983Z","__v":0},{"_id":"6ac4f5f23c2b860edea6da0d","deploymentId":"68c9bcd7a1b07562da8b036b","questionText":"How are secrets stored safely?","status":"active","generatedBy":"contextual","path":"ai-studio/organization/secrets","createdAt":"2026-10-06T13:21:54.983Z","updatedAt":"2026-10-06T13:21:54.983Z","__v":0},{"_id":"6ac4f5f23c2b860edea6da0b","deploymentId":"68c9bcd7a1b07562da8b036b","questionText":"How do I rotate API keys?","status":"active","generatedBy":"contextual","path":"ai-studio/organization/secrets","createdAt":"2026-10-06T13:21:54.983Z","updatedAt":"2026-10-06T13:21:54.983Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-06T13:21:47.811Z","originalFileLocation":"ai-studio/organization/secrets.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"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=\"Where Orq.ai stores API Keys, provider credentials, secret variables, and signing secrets, who can read each one, and how to rotate it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Orq.ai Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/orqai/5zquLIiRlftT1q7X/_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/orqai/5zquLIiRlftT1q7X/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/orqai/5zquLIiRlftT1q7X/_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/orqai/5zquLIiRlftT1q7X/_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/orqai/5zquLIiRlftT1q7X/_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/orqai/5zquLIiRlftT1q7X/_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/orqai/5zquLIiRlftT1q7X/_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/orqai/5zquLIiRlftT1q7X/_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/orqai/5zquLIiRlftT1q7X/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Secrets management - Orq.ai Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Where Orq.ai stores API Keys, provider credentials, secret variables, and signing secrets, who can read each one, and how to rotate it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Orq.ai Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.orq.ai/ai-studio/organization/secrets\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://orqai.mintlify.app/_mintlify/api/og/v2?division=Security+%26+Compliance\u0026amp;title=Secrets+management\u0026amp;description=Where+Orq.ai+stores+API+Keys%2C+provider+credentials%2C+secret+variables%2C+and+signing+secrets%2C+who+can+read+each+one%2C+and+how+to+rotate+it.\u0026amp;theme=0116d0baa6ba6403f431e631\u0026amp;signature=77687cbf80618d175953e600976791cbc3cc1bc8c54c4412872884d71a98ffd0\">\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=\"Secrets management - Orq.ai Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Where Orq.ai stores API Keys, provider credentials, secret variables, and signing secrets, who can read each one, and how to rotate it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://orqai.mintlify.app/_mintlify/api/og/v2?division=Security+%26+Compliance\u0026amp;title=Secrets+management\u0026amp;description=Where+Orq.ai+stores+API+Keys%2C+provider+credentials%2C+secret+variables%2C+and+signing+secrets%2C+who+can+read+each+one%2C+and+how+to+rotate+it.\u0026amp;theme=0116d0baa6ba6403f431e631\u0026amp;signature=77687cbf80618d175953e600976791cbc3cc1bc8c54c4412872884d71a98ffd0\">\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/orqai/5zquLIiRlftT1q7X/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Orq.ai Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#027f6b\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"author\" content=\"Orq.ai\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@orq_ai\">\u003cmeta data-mint-head name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\u003cmeta data-mint-head name=\"language\" content=\"English\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.orq.ai/ai-studio/organization/secrets\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ai-studio/organization/secrets.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.orq.ai/#organization\",\"name\":\"Orq.ai\",\"legalName\":\"Orq.AI Holding B.V.\",\"url\":\"https://orq.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://docs.orq.ai/images/Orq_ai_Symbol_Dark.svg\"},\"sameAs\":[\"https://github.com/orq-ai\",\"https://x.com/orq_ai\",\"https://www.linkedin.com/company/orqai/\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.orq.ai#website\",\"name\":\"Orq.ai Documentation\",\"url\":\"https://docs.orq.ai\",\"publisher\":{\"@id\":\"https://docs.orq.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.orq.ai/ai-studio/organization/secrets#webpage\",\"url\":\"https://docs.orq.ai/ai-studio/organization/secrets\",\"name\":\"Secrets management\",\"description\":\"Where Orq.ai stores API Keys, provider credentials, secret variables, and signing secrets, who can read each one, and how to rotate it.\",\"dateModified\":\"2026-10-06T13:21:47.811Z\",\"isPartOf\":{\"@id\":\"https://docs.orq.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.orq.ai/ai-studio/organization/secrets#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.orq.ai/ai-studio/organization/secrets#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Orq.ai Documentation\",\"item\":\"https://docs.orq.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Secrets management\",\"item\":\"https://docs.orq.ai/ai-studio/organization/secrets\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.orq.ai/ai-studio/organization/secrets#article\",\"headline\":\"Secrets management\",\"name\":\"Secrets management\",\"description\":\"Where Orq.ai stores API Keys, provider credentials, secret variables, and signing secrets, who can read each one, and how to rotate it.\",\"url\":\"https://docs.orq.ai/ai-studio/organization/secrets\",\"mainEntityOfPage\":{\"@id\":\"https://docs.orq.ai/ai-studio/organization/secrets#webpage\"},\"dateModified\":\"2026-10-06T13:21:47.811Z\",\"publisher\":{\"@id\":\"https://docs.orq.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.orq.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Orq.ai Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Orq.ai Documentation","nav":{"global":null,"tabs":[{"tab":"AI Gateway","pages":[{"title":"AI Gateway","href":"/ai-gateway/get-started/introduction"}]},{"tab":"AI Observability","pages":[{"title":"AI Observability","href":"/ai-studio/observability/quickstart"}]},{"tab":"Managed agents","pages":[{"title":"Managed agents","href":"/ai-studio/ai-engineering/quickstart"}]},{"tab":"Administration","groups":[{"group":"Workspace \u0026 Projects","icon":"building","pages":[{"title":"General Settings","href":"/ai-studio/organization/workspace-settings"},{"title":"Projects in Orq.ai","sidebarTitle":"Projects","href":"/ai-studio/get-started/projects"},{"title":"Favorites","sidebarTitle":"Favorites","href":"/ai-studio/get-started/favorites"},{"title":"Customize the sidebar","sidebarTitle":"Sidebar","href":"/ai-studio/get-started/sidebar"},{"title":"Tabs","sidebarTitle":"Tabs","href":"/ai-studio/get-started/tabs"},{"title":"Chat","sidebarTitle":"Using Chat","href":"/ai-studio/ai-chat/using-chat"}]},{"group":"Identity \u0026 Access","icon":"users-gear","pages":[{"title":"Members and teams","sidebarTitle":"Members and Teams","href":"/ai-studio/organization/members-teams"},{"title":"API Keys","sidebarTitle":"API Keys","href":"/ai-studio/organization/api-keys"},{"title":"Management Keys","sidebarTitle":"Management Keys","href":"/ai-studio/organization/management-keys"},{"title":"Workspace Audit Logs","sidebarTitle":"Audit Logs","href":"/ai-studio/organization/audit-logs"},{"title":"Enterprise SSO authentication","sidebarTitle":"Single Sign-On","tag":"Enterprise","href":"/ai-studio/organization/sso"},{"title":"Workload federation","sidebarTitle":"Workload federation","tag":"Enterprise","href":"/ai-studio/organization/workload-federation"},{"title":"Environments for dev, staging, and production","sidebarTitle":"Environments","href":"/ai-studio/organization/environments"},{"title":"Webhooks for real-time notifications","sidebarTitle":"Webhooks","href":"/ai-studio/organization/webhooks"}]},{"group":"Billing \u0026 Usage","icon":"wallet","pages":[{"title":"Pricing","url":"https://orq.ai/pricing","href":"/pricing"},{"title":"Billing and credits","sidebarTitle":"Billing \u0026 Credits","href":"/ai-studio/organization/billing-usage"},{"title":"Budgets","sidebarTitle":"Budgets","description":"Set spending limits on any scope (workspace, project, identity, API key, provider, or model) to control AI costs across the organization.","href":"/ai-gateway/budgets"}]},{"group":"Security \u0026 Compliance","icon":"shield-halved","pages":[{"title":"Secrets management","sidebarTitle":"Secrets","href":"/ai-studio/organization/secrets"},{"title":"Workspace security controls","sidebarTitle":"Workspace Security","description":"Verify workspace domain ownership with DNS TXT records and restrict Orq.ai workspace access with an IP allowlist.","href":"/ai-studio/organization/workspace-security"},{"title":"Data compliance and privacy","sidebarTitle":"Data Compliance","href":"/ai-studio/organization/data-compliance"},{"title":"Data retention","sidebarTitle":"Data Retention","href":"/ai-studio/organization/data-retention"},{"title":"Plugins","sidebarTitle":"Plugins","href":"/ai-gateway/features/plugins/overview"},{"title":"Trust center and compliance","sidebarTitle":"Trust Center","href":"/enterprise/trust"},{"title":"Governing Shadow AI","sidebarTitle":"Shadow AI","href":"/enterprise/shadow-ai"}]},{"group":"Support","icon":"clipboard-check","pages":[{"title":"Status and support","sidebarTitle":"Status \u0026 Support","href":"/status-and-support"}]},{"group":"Enterprise Deployment","icon":"cloud","pages":[{"title":"Deployment Options","href":"/enterprise/deployment-options"},{"title":"VPC deployment on AWS or Azure","sidebarTitle":"VPC Deployment","href":"/enterprise/vpc-deployment"},{"title":"On-premise deployment requirements","sidebarTitle":"On-Prem Requirements","href":"/enterprise/on-prem-requirements"},{"title":"Agent sandbox for on-premise","sidebarTitle":"Agent Sandbox","href":"/enterprise/agent-sandbox"}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/ai-studio/integrations/overview"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/client-libraries"}]},{"tab":"Cookbooks","hidden":true,"pages":[{"title":"Cookbooks","href":"/ai-studio/cookbooks/cookbooks"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/release-4-17"}]}]},"basePath":"","title":"Secrets management - Orq.ai Documentation","buildId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","deploymentId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","dynamics":[],"chunks":[]}