An API token for one organization. You create and revoke tokens in the dashboard. A token scoped to one App can reach only that App, so give that kind of token to an agent. An organization-wide token can create a short-lived one with POST /api/tokens.
Scopes
apps:read
OAuth
See the organization's Apps, with their files, deployments, and logs.
apps:read
DPoP
Path Parameters
id
string
required
A unique ID that starts with app_.
Pattern: ^app_[0-9A-Za-z]{24}$
Example:
"app_Zj7XhMgplmTJcp5Dk4vcYuk0"
name
string
required
The Secret's name: uppercase letters, digits, and underscores, not starting with a digit. The App reads the value as an environment variable with this name.
Pattern: ^[A-Z_][A-Z0-9_]{0,127}$
Example:
"STRIPE_SECRET_KEY"
Response
The Secret, without its value.
id
string
required
The Secret's ID, which starts with sec_.
app_id
string
required
The ID of the App that the Secret belongs to.
name
string
required
The Secret's name. The App reads the value as an environment variable with this name.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Judt","description":"Give your agent the ability to build and publish powerful, realtime, dynamic Apps and Websites.","colors":{"primary":"#E43636","light":"#FFFFFF","dark":"#000000"},"logo":{"light":"https://mintcdn.com/judt/fLHZClc2FLrKxJ_W/images/judt-logo.svg?fit=max\u0026auto=format\u0026n=fLHZClc2FLrKxJ_W\u0026q=85\u0026s=74bb26a7428d0124254a5edb052208db","dark":"https://mintcdn.com/judt/fLHZClc2FLrKxJ_W/images/judt-logo.svg?fit=max\u0026auto=format\u0026n=fLHZClc2FLrKxJ_W\u0026q=85\u0026s=74bb26a7428d0124254a5edb052208db","href":"https://judt.ai"},"favicon":{"light":"https://mintcdn.com/judt/2s5Qii8OX7bN-fZp/images/red-01.svg?fit=max\u0026auto=format\u0026n=2s5Qii8OX7bN-fZp\u0026q=85\u0026s=9ceea1c72bdeebc33354323ff61e7a82","dark":"https://mintcdn.com/judt/2s5Qii8OX7bN-fZp/images/red-01.svg?fit=max\u0026auto=format\u0026n=2s5Qii8OX7bN-fZp\u0026q=85\u0026s=9ceea1c72bdeebc33354323ff61e7a82"},"appearance":{"default":"light","strict":true},"navbar":{"primary":{"type":"button","label":"Go to Dashboard","href":"https://judt.ai/apps"}},"seo":{"indexing":"all"},"fonts":{"heading":{"family":"General Sans","weight":700},"body":{"family":"switzer","weight":400}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view"],"display":"toc"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"judt","hasAudioNarration":false,"actualSubdomain":"judt","customDomains":["docs.judt.ai"],"gitSource":{"type":"github","owner":"judt-ai","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":false,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6af260d84450952f7c00a1c4","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API Reference","count":45},{"language":"default","tag":"Build Apps","count":19},{"language":"default","tag":"Manage Apps","count":15},{"language":"default","tag":"Agents","count":12},{"language":"default","tag":"Get started","count":7},{"language":"default","tag":"Apps","count":7},{"language":"default","tag":"Sandbox","count":7},{"language":"default","tag":"Guides","count":5},{"language":"default","tag":"Project","count":4},{"language":"default","tag":"Storage","count":4}]},"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":"style.css","content":"@import url(\"https://api.fontshare.com/v2/css?f[]=general-sans@700\u0026f[]=switzer@400\u0026display=swap\");:root{--font-heading: \"General Sans\", sans-serif;--font-body: \"Switzer\", sans-serif}body{font-family:var(--font-body)!important;font-weight:400}*,*::before,*::after{border-radius:0!important}h1,h2,h3,h4,h5,h6{font-family:var(--font-heading)!important;font-weight:700}"}],"page":{"pagePath":"api-reference/secrets/get-a-secret","slug":"/api-reference/secrets/get-a-secret","pageMetadata":{"title":"Get a Secret","description":"Returns a Secret by name, without its value.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/secrets/{name}","href":"/api-reference/secrets/get-a-secret","autogeneratedByOpenApi":true},"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: \"Returns a Secret by name, without its value.\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get a Secret","description":"Returns a Secret by name, without its value.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/secrets/{name}","href":"/api-reference/secrets/get-a-secret","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Get a Secret","description":"Returns a Secret by name, without its value.","tags":["Secrets"],"operationId":"get_secret","security":["94675cf2-39df-412e-bef8-cc1a85cb5f6e","966cff5d-849f-4ac6-877c-8f3102568a0a","af958d81-d8fd-4bdf-a570-fabc870d1efa"],"parameters":["fbe59d0b-4aac-411c-8f59-d3c7e05f69b4","9e043bdb-b856-4f01-861e-b6203a186388"],"responses":{"200":"837eeb40-23ec-414a-a7cd-beedbccf6942","401":"19858da7-4bda-4d92-8769-52f9d25a57f6","403":"87aa09aa-9104-4ca5-a6ad-530a7f14b6cd","404":"cd42c549-2c28-4b65-83d6-b2beddb2ddbc","410":"f8ebb14d-df94-4f00-b332-9500594611f3"},"method":"get","type":"path","servers":["b2c0c780-a427-4ff6-96e6-3611f64a9207"],"path":"/api/apps/{id}/secrets/{name}","baseUrlOptions":["https://api.judt.ai"],"title":"Get a Secret","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"fbe59d0b-4aac-411c-8f59-d3c7e05f69b4":{"name":"id","in":"path","required":true,"description":"A unique ID that starts with `app_`.","schema":{"type":"string","pattern":"^app_[0-9A-Za-z]{24}$","example":"app_Zj7XhMgplmTJcp5Dk4vcYuk0","isRequired":true,"description":"A unique ID that starts with `app_`.","uniqueKey":"","typeLabel":"string"}},"9e043bdb-b856-4f01-861e-b6203a186388":{"name":"name","in":"path","required":true,"description":"The Secret's name: uppercase letters, digits, and underscores, not starting with a digit. The App reads the value as an environment variable with this name.","schema":{"type":"string","pattern":"^[A-Z_][A-Z0-9_]{0,127}$","example":"STRIPE_SECRET_KEY","isRequired":true,"description":"The Secret's name: uppercase letters, digits, and underscores, not starting with a digit. The App reads the value as an environment variable with this name.","uniqueKey":"","typeLabel":"string"}}},"responses":{"837eeb40-23ec-414a-a7cd-beedbccf6942":{"description":"The Secret, without its value.","headers":{},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"The Secret's ID, which starts with `sec_`.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"app_id":{"type":"string","description":"The ID of the App that the Secret belongs to.","isRequired":true,"uniqueKey":"app_id","typeLabel":"string"},"name":{"type":"string","description":"The Secret's name. The App reads the value as an environment variable with this name.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","description":"When the Secret was created.","example":"2026-10-03T14:01:30.000Z","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","description":"When the Secret's name or value last changed.","example":"2026-10-03T14:01:30.000Z","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"}},"required":["id","app_id","name","created_at","updated_at"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","app_id":"\u003cstring>","name":"\u003cstring>","created_at":"2026-10-03T14:01:30.000Z","updated_at":"2026-10-03T14:01:30.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"19858da7-4bda-4d92-8769-52f9d25a57f6":{"description":"An error, with its code and the request ID.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"A stable code for the error, such as `not_found`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A readable explanation of the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"The request's ID. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"detail":{"type":"string","description":"More information, if any: the sandbox's error, a provider message, or, for a `504`, how far the work got and the ID of its latest event.","uniqueKey":"error.detail","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","detail":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"87aa09aa-9104-4ca5-a6ad-530a7f14b6cd":{"description":"An error, with its code and the request ID.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"A stable code for the error, such as `not_found`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A readable explanation of the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"The request's ID. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"detail":{"type":"string","description":"More information, if any: the sandbox's error, a provider message, or, for a `504`, how far the work got and the ID of its latest event.","uniqueKey":"error.detail","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","detail":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"cd42c549-2c28-4b65-83d6-b2beddb2ddbc":{"description":"An error, with its code and the request ID.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"A stable code for the error, such as `not_found`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A readable explanation of the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"The request's ID. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"detail":{"type":"string","description":"More information, if any: the sandbox's error, a provider message, or, for a `504`, how far the work got and the ID of its latest event.","uniqueKey":"error.detail","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","detail":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"f8ebb14d-df94-4f00-b332-9500594611f3":{"description":"An error, with its code and the request ID.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"A stable code for the error, such as `not_found`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A readable explanation of the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"The request's ID. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"detail":{"type":"string","description":"More information, if any: the sandbox's error, a provider message, or, for a `504`, how far the work got and the ID of its latest event.","uniqueKey":"error.detail","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","detail":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"94675cf2-39df-412e-bef8-cc1a85cb5f6e":{"ApiToken":{"type":"http","scheme":"bearer","description":"An API token for one organization. You create and revoke tokens in the dashboard. A token scoped to one App can reach only that App, so give that kind of token to an agent. An organization-wide token can create a short-lived one with `POST /api/tokens`.","scopes":[],"schemeName":"ApiToken"}},"966cff5d-849f-4ac6-877c-8f3102568a0a":{"OAuth":{"type":"oauth2","description":"An OAuth access token for one person and organization, sent as a bearer token. https://judt.ai/auth.md describes the ways an agent can get one. Request the resource https://api.judt.ai, and also https://api.judt.ai/mcp to use the same token on the MCP server. The person's role still applies.","flows":{"authorizationCode":{"authorizationUrl":"https://judt.ai/api/auth/oauth2/authorize","tokenUrl":"https://judt.ai/api/auth/oauth2/token","refreshUrl":"https://judt.ai/api/auth/oauth2/token","scopes":{"apps:read":"See the organization's Apps, with their files, deployments, and logs.","apps:write":"Change the organization's Apps: edit files, run commands, deploy, and manage Secrets."}}},"scopes":["apps:read"],"schemeName":"OAuth"}},"af958d81-d8fd-4bdf-a570-fabc870d1efa":{"DPoP":{"type":"http","scheme":"DPoP","description":"An OAuth access token bound to a DPoP key (RFC 9449), sent with a DPoP proof. A token request with a DPoP proof gets one, and a Personal Agent Protocol Session Token is one: a Personal Agent starts at https://judt.ai/.well-known/poppy.json. Scopes are the same as for OAuth.","scopes":["apps:read"],"schemeName":"DPoP"}}},"servers":{"b2c0c780-a427-4ff6-96e6-3611f64a9207":{"url":"https://api.judt.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An API token for one organization. You create and revoke tokens in the dashboard. A token scoped to one App can reach only that App, so give that kind of token to an agent. An organization-wide token can create a short-lived one with `POST /api/tokens`.","scopes":[],"schemeName":"ApiToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API token for one organization. You create and revoke tokens in the dashboard. A token scoped to one App can reach only that App, so give that kind of token to an agent. An organization-wide token can create a short-lived one with `POST /api/tokens`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiToken","name":"Authorization"}],"title":"ApiToken"},{"schemes":[{"scheme":{"type":"oauth2","description":"An OAuth access token for one person and organization, sent as a bearer token. https://judt.ai/auth.md describes the ways an agent can get one. Request the resource https://api.judt.ai, and also https://api.judt.ai/mcp to use the same token on the MCP server. The person's role still applies.","flows":{"authorizationCode":{"authorizationUrl":"https://judt.ai/api/auth/oauth2/authorize","tokenUrl":"https://judt.ai/api/auth/oauth2/token","refreshUrl":"https://judt.ai/api/auth/oauth2/token","scopes":{"apps:read":"See the organization's Apps, with their files, deployments, and logs.","apps:write":"Change the organization's Apps: edit files, run commands, deploy, and manage Secrets."}}},"scopes":["apps:read"],"schemeName":"OAuth"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"An OAuth access token for one person and organization, sent as a bearer token. https://judt.ai/auth.md describes the ways an agent can get one. Request the resource https://api.judt.ai, and also https://api.judt.ai/mcp to use the same token on the MCP server. The person's role still applies.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OAuth","name":"Authorization"}],"title":"OAuth"},{"schemes":[{"scheme":{"type":"http","scheme":"DPoP","description":"An OAuth access token bound to a DPoP key (RFC 9449), sent with a DPoP proof. A token request with a DPoP proof gets one, and a Personal Agent Protocol Session Token is one: a Personal Agent starts at https://judt.ai/.well-known/poppy.json. Scopes are the same as for OAuth.","scopes":["apps:read"],"schemeName":"DPoP"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An OAuth access token bound to a DPoP key (RFC 9449), sent with a DPoP proof. A token request with a DPoP proof gets one, and a Personal Agent Protocol Session Token is one: a Personal Agent starts at https://judt.ai/.well-known/poppy.json. Scopes are the same as for OAuth.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"DPoP","name":"Authorization"}],"title":"DPoP"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"judt","siteName":"Judt","title":"Get a Secret - Judt","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T00:10:04.663Z","originalFileLocation":"api-reference/secrets/get-a-secret.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"Returns a Secret by name, without its value.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Judt\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/judt/4xH8o5IVMj62_yiA/_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/judt/4xH8o5IVMj62_yiA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/judt/4xH8o5IVMj62_yiA/_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/judt/4xH8o5IVMj62_yiA/_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/judt/4xH8o5IVMj62_yiA/_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/judt/4xH8o5IVMj62_yiA/_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/judt/4xH8o5IVMj62_yiA/_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/judt/4xH8o5IVMj62_yiA/_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/judt/4xH8o5IVMj62_yiA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a Secret - Judt\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a Secret by name, without its value.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Judt\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.judt.ai/api-reference/secrets/get-a-secret\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://judt.mintlify.site/_mintlify/api/og/v2?division=Secrets\u0026amp;title=Get+a+Secret\u0026amp;description=Returns+a+Secret+by+name%2C+without+its+value.\u0026amp;theme=52d45eb14d1a23098b96d158\u0026amp;signature=586a76f462effdfd8efbacda3d207f2e884a23b5b728fd71627ef7349364808b\">\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=\"Get a Secret - Judt\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a Secret by name, without its value.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://judt.mintlify.site/_mintlify/api/og/v2?division=Secrets\u0026amp;title=Get+a+Secret\u0026amp;description=Returns+a+Secret+by+name%2C+without+its+value.\u0026amp;theme=52d45eb14d1a23098b96d158\u0026amp;signature=586a76f462effdfd8efbacda3d207f2e884a23b5b728fd71627ef7349364808b\">\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/judt/4xH8o5IVMj62_yiA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Judt\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E43636\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.judt.ai/api-reference/secrets/get-a-secret\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/secrets/get-a-secret.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.judt.ai/#organization\",\"name\":\"Judt\",\"url\":\"https://docs.judt.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/judt/fLHZClc2FLrKxJ_W/images/judt-logo.svg?fit=max\u0026auto=format\u0026n=fLHZClc2FLrKxJ_W\u0026q=85\u0026s=74bb26a7428d0124254a5edb052208db\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.judt.ai#website\",\"name\":\"Judt\",\"url\":\"https://docs.judt.ai\",\"publisher\":{\"@id\":\"https://docs.judt.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.judt.ai/api-reference/secrets/get-a-secret#webpage\",\"url\":\"https://docs.judt.ai/api-reference/secrets/get-a-secret\",\"name\":\"Get a Secret\",\"description\":\"Returns a Secret by name, without its value.\",\"dateModified\":\"2026-11-10T00:10:04.663Z\",\"isPartOf\":{\"@id\":\"https://docs.judt.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.judt.ai/api-reference/secrets/get-a-secret#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.judt.ai/api-reference/secrets/get-a-secret#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Secrets\",\"item\":\"https://docs.judt.ai/api-reference/secrets/list-secrets\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a Secret\",\"item\":\"https://docs.judt.ai/api-reference/secrets/get-a-secret\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.judt.ai/api-reference/secrets/get-a-secret#apireference\",\"headline\":\"Get a Secret\",\"name\":\"Get a Secret\",\"description\":\"Returns a Secret by name, without its value.\",\"url\":\"https://docs.judt.ai/api-reference/secrets/get-a-secret\",\"mainEntityOfPage\":{\"@id\":\"https://docs.judt.ai/api-reference/secrets/get-a-secret#webpage\"},\"dateModified\":\"2026-11-10T00:10:04.663Z\",\"publisher\":{\"@id\":\"https://docs.judt.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.judt.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Judt\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Judt\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/secrets/get-a-secret.md","siteName":"Judt","nav":{"global":null,"tabs":[{"tab":"Manage Apps","pages":[{"title":"Manage Apps","href":"/manage/introduction"}]},{"tab":"Build Apps","pages":[{"title":"Build Apps","href":"/build/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API reference","sidebarTitle":"Introduction","href":"/api-reference/introduction"}]},{"group":"Account","pages":[{"title":"Get the caller","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/me","href":"/api-reference/account/get-the-caller"}]},{"group":"Apps","pages":[{"title":"Create an App","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps","href":"/api-reference/apps/create-an-app"},{"title":"List Apps","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps","href":"/api-reference/apps/list-apps"},{"title":"Get an App","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}","href":"/api-reference/apps/get-an-app"},{"title":"Update an App","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/apps/{id}","href":"/api-reference/apps/update-an-app"},{"title":"Delete an App","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/apps/{id}","href":"/api-reference/apps/delete-an-app"},{"title":"Create a visitor token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/visitor-tokens","href":"/api-reference/apps/create-a-visitor-token"},{"title":"Create a deep link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/deep-links","href":"/api-reference/apps/create-a-deep-link"}]},{"group":"Tokens","pages":[{"title":"Create an App token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/tokens","href":"/api-reference/tokens/create-an-app-token"}]},{"group":"Secrets","pages":[{"title":"List Secrets","description":"Lists the App's Secrets by name. Responses never include Secret values.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/secrets","href":"/api-reference/secrets/list-secrets"},{"title":"Get a Secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/secrets/{name}","href":"/api-reference/secrets/get-a-secret"},{"title":"Set a Secret","description":"Creates the Secret with this name, or replaces its value. A running sandbox's dev server gets the new value at once, and production gets it at the next deploy.\n\nIf a waiting agent turn requested this Secret, and it's the last one that the turn needs, the turn resumes.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/apps/{id}/secrets/{name}","href":"/api-reference/secrets/set-a-secret"},{"title":"Delete a Secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/apps/{id}/secrets/{name}","href":"/api-reference/secrets/delete-a-secret"}]},{"group":"Files","pages":[{"title":"List files","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/files","href":"/api-reference/files/list-files"},{"title":"Read a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/files/{path}","href":"/api-reference/files/read-a-file"},{"title":"Write a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/apps/{id}/files/{path}","href":"/api-reference/files/write-a-file"},{"title":"Delete a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/apps/{id}/files/{path}","href":"/api-reference/files/delete-a-file"}]},{"group":"Sandbox","pages":[{"title":"Run a command","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/commands","href":"/api-reference/sandbox/run-a-command"},{"title":"Get Git information","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/git","href":"/api-reference/sandbox/get-git-information"},{"title":"Create a commit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/commits","href":"/api-reference/sandbox/create-a-commit"},{"title":"List commits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/commits","href":"/api-reference/sandbox/list-commits"},{"title":"Restore a commit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/restore","href":"/api-reference/sandbox/restore-a-commit"},{"title":"Create a preview link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/preview","href":"/api-reference/sandbox/create-a-preview-link"},{"title":"Stop the sandbox","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/stop","href":"/api-reference/sandbox/stop-the-sandbox"}]},{"group":"Deployments","pages":[{"title":"Deploy the App","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/deployments","href":"/api-reference/deployments/deploy-the-app"},{"title":"List deployments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/deployments","href":"/api-reference/deployments/list-deployments"},{"title":"Get a deployment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/deployments/{deployment_id}","href":"/api-reference/deployments/get-a-deployment"},{"title":"Unpublish an App","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/unpublish","href":"/api-reference/deployments/unpublish-an-app"}]},{"group":"Monitoring","pages":[{"title":"List App events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/events","href":"/api-reference/monitoring/list-app-events"},{"title":"List logs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/logs","href":"/api-reference/monitoring/list-logs"}]},{"group":"Templates","pages":[{"title":"List templates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/templates","href":"/api-reference/templates/list-templates"}]},{"group":"Agents","pages":[{"title":"List models","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/models","href":"/api-reference/agents/list-models"},{"title":"Create a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/sessions","href":"/api-reference/agents/create-a-session"},{"title":"List sessions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/sessions","href":"/api-reference/agents/list-sessions"},{"title":"Get a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/sessions/{session_id}","href":"/api-reference/agents/get-a-session"},{"title":"Update a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/apps/{id}/sessions/{session_id}","href":"/api-reference/agents/update-a-session"},{"title":"Delete a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/apps/{id}/sessions/{session_id}","href":"/api-reference/agents/delete-a-session"},{"title":"Send a message","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/sessions/{session_id}/turns","href":"/api-reference/agents/send-a-message"},{"title":"List turns","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/sessions/{session_id}/turns","href":"/api-reference/agents/list-turns"},{"title":"Get a turn","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/sessions/{session_id}/turns/{turn_id}","href":"/api-reference/agents/get-a-turn"},{"title":"Cancel a turn","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/sessions/{session_id}/turns/{turn_id}/cancel","href":"/api-reference/agents/cancel-a-turn"},{"title":"Decline an input request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/sessions/{session_id}/turns/{turn_id}/decline","href":"/api-reference/agents/decline-an-input-request"},{"title":"List session events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/sessions/{session_id}/events","href":"/api-reference/agents/list-session-events"}]},{"group":"Feedback","pages":[{"title":"Send feedback","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/feedback","href":"/api-reference/feedback/send-feedback"}]}]}]},"basePath":"","title":"Get a Secret - Judt","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","b0f84f53ff","2b790eda92","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-BIYvYBgk.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}