The token is shown only once. Unavailable during impersonation. Required scope: agents:write. Requires a human owner/admin session; agent API keys and delegated OAuth cannot administer the workspace.
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Papers","description":"Email and SMS for agents. API guides, SDKs, permissions, and webhooks.","colors":{"primary":"#166E3F","light":"#26BD6C","dark":"#166E3F"},"logo":{"light":"https://mintcdn.com/papers/Lj6dvnd84QsF84tm/logo/light.svg?fit=max\u0026auto=format\u0026n=Lj6dvnd84QsF84tm\u0026q=85\u0026s=92cfb4e0bedd5b76fc6a17b86f6db9c0","dark":"https://mintcdn.com/papers/Lj6dvnd84QsF84tm/logo/dark.svg?fit=max\u0026auto=format\u0026n=Lj6dvnd84QsF84tm\u0026q=85\u0026s=572075ab1ddd2fd406d68e4b10c84715"},"favicon":"https://mintcdn.com/papers/Lj6dvnd84QsF84tm/favicon.svg?fit=max\u0026auto=format\u0026n=Lj6dvnd84QsF84tm\u0026q=85\u0026s=93f56e73f76a5db53ad9957c2fa3cc0e","navbar":{"links":[{"href":"https://www.papers.bot/pricing","label":"Pricing"}],"primary":{"type":"button","label":"Dashboard","href":"https://www.papers.bot/dashboard"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"papers","hasAudioNarration":false,"actualSubdomain":"papers","customDomains":["www.papers.bot"],"gitSource":{"type":"github","owner":"gmpetrov","repo":"papers","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ab2a48f716060868ac38000","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API reference","count":47},{"language":"default","tag":"Guides","count":24},{"language":"default","tag":"Workspace","count":8},{"language":"default","tag":"Email","count":7},{"language":"default","tag":"Phone numbers","count":7},{"language":"default","tag":"Webhook endpoints","count":7},{"language":"default","tag":"Inboxes","count":6},{"language":"default","tag":"Billing","count":5},{"language":"default","tag":"Connect your agent","count":4},{"language":"default","tag":"Get started","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","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":true},"customCss":[],"page":{"pagePath":"api-reference/api-keys/issue-a-scoped-workspace-api-key","slug":"/api-reference/api-keys/issue-a-scoped-workspace-api-key","pageMetadata":{"title":"Issue a scoped workspace API key","description":"The token is shown only once. Unavailable during impersonation. Required scope: agents:write. Requires a human owner/admin session; agent API keys and delegated OAuth cannot administer the workspace.","deprecated":null,"version":null,"openapi":"/openapi.json post /api-keys","href":"/api-reference/api-keys/issue-a-scoped-workspace-api-key","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: \"The token is shown only once. Unavailable during impersonation. Required scope: agents:write. Requires a human owner/admin session; agent API keys and delegated OAuth cannot administer the workspace.\"\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":"Issue a scoped workspace API key","description":"The token is shown only once. Unavailable during impersonation. Required scope: agents:write. Requires a human owner/admin session; agent API keys and delegated OAuth cannot administer the workspace.","deprecated":null,"version":null,"openapi":"/openapi.json post /api-keys","href":"/api-reference/api-keys/issue-a-scoped-workspace-api-key","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createApiKey","security":["27e0441c-3034-43cb-b65b-8354133f522a"],"summary":"Issue a scoped workspace API key","description":"The token is shown only once. Unavailable during impersonation. Required scope: agents:write. Requires a human owner/admin session; agent API keys and delegated OAuth cannot administer the workspace.","parameters":[],"responses":{"200":"1b619db5-02f2-49c7-a286-bfdd5ce9c2eb","201":"d8137b10-9871-4616-8c16-e5e0e70aabbf","429":"d84e1283-354a-42b4-b02a-f42cb1d048c6","default":"7c1542c4-d6ae-467d-bbc2-b357d0dbab7e"},"requestBody":"036d2df1-21f5-42ed-83a9-459843c37758","x-required-scopes":["agents:write"],"tags":["API keys"],"method":"post","type":"path","servers":["5cf79b0f-3136-4019-b712-baaabf586852"],"path":"/api-keys","baseUrlOptions":["https://www.papers.bot/v1"],"title":"Issue a scoped workspace API key","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80,"isRequired":true,"uniqueKey":"name","typeLabel":"string"},"scopes":{"minItems":1,"type":"array","items":{"type":"string","enum":["agents:read","agents:write","inboxes:read","inboxes:write","email:send","numbers:read","sms:read","numbers:provision","numbers:release","sms:send","events:read"],"uniqueKey":"scopes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"scopes","typeLabel":"enum\u003cstring>[]"},"resourceGrants":{"oneOf":[{"type":"object","properties":{"inboxIds":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"resourceGrants.oneOf.0.inboxIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"resourceGrants.oneOf.0.inboxIds","typeLabel":"string[]"},"phoneNumberIds":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"resourceGrants.oneOf.0.phoneNumberIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"resourceGrants.oneOf.0.phoneNumberIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"resourceGrants.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"resourceGrants.oneOf.1","typeLabel":"null"}],"uniqueKey":"resourceGrants","typeLabel":"object | null"},"dailyInboxLimit":{"oneOf":[{"type":"integer","maximum":10000,"minimum":0,"uniqueKey":"dailyInboxLimit.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"dailyInboxLimit.oneOf.1","typeLabel":"null"}],"uniqueKey":"dailyInboxLimit","typeLabel":"integer | null"},"dailyNumberLimit":{"oneOf":[{"type":"integer","maximum":10000,"minimum":0,"uniqueKey":"dailyNumberLimit.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"dailyNumberLimit.oneOf.1","typeLabel":"null"}],"uniqueKey":"dailyNumberLimit","typeLabel":"integer | null"},"dailyEmailLimit":{"oneOf":[{"type":"integer","maximum":10000,"minimum":0,"uniqueKey":"dailyEmailLimit.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"dailyEmailLimit.oneOf.1","typeLabel":"null"}],"uniqueKey":"dailyEmailLimit","typeLabel":"integer | null"},"dailySmsLimit":{"oneOf":[{"type":"integer","maximum":10000,"minimum":0,"uniqueKey":"dailySmsLimit.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"dailySmsLimit.oneOf.1","typeLabel":"null"}],"uniqueKey":"dailySmsLimit","typeLabel":"integer | null"},"agentId":{"type":"string","minLength":1,"uniqueKey":"agentId","typeLabel":"string"},"expiresInDays":{"default":90,"type":"integer","minimum":1,"maximum":365,"uniqueKey":"expiresInDays","typeLabel":"integer"}},"required":["name","scopes"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","scopes":[],"resourceGrants":{"inboxIds":[],"phoneNumberIds":[]},"dailyInboxLimit":5000,"dailyNumberLimit":5000,"dailyEmailLimit":5000,"dailySmsLimit":5000,"agentId":"\u003cstring>","expiresInDays":90}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"1b619db5-02f2-49c7-a286-bfdd5ce9c2eb":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{}}},"exampleType":"generated"}},"exampleType":"generated"},"d8137b10-9871-4616-8c16-e5e0e70aabbf":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{}}},"exampleType":"generated"}},"exampleType":"generated"},"d84e1283-354a-42b4-b02a-f42cb1d048c6":{"description":"Request rate limit or communication quota exceeded. Rate-limit responses include Retry-After.","headers":{"Retry-After":{"description":"Seconds until the request-rate window resets (rate_limited errors)","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"details":{"oneOf":[{"type":"object","required":["approvalId"],"properties":{"approvalId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"error.details.oneOf.0.approvalId","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.details.oneOf.1.items.[INDEX].code","typeLabel":"string"},"path":{"type":"array","items":{"oneOf":[{"type":"string","uniqueKey":"error.details.oneOf.1.items.[INDEX].path.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"number","uniqueKey":"error.details.oneOf.1.items.[INDEX].path.items.[INDEX].oneOf.1","typeLabel":"number"}],"uniqueKey":"error.details.oneOf.1.items.[INDEX].path.items.[INDEX]","typeLabel":"string | number"},"isRequired":true,"uniqueKey":"error.details.oneOf.1.items.[INDEX].path","typeLabel":"(string | number)[]"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.oneOf.1.items.[INDEX].message","typeLabel":"string"}},"required":["code","path","message"],"additionalProperties":false,"uniqueKey":"error.details.oneOf.1.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"error.details","typeLabel":"object | object[]"}},"required":["code","message","request_id","retryable"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","retryable":true,"details":{"approvalId":"\u003cstring>"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"7c1542c4-d6ae-467d-bbc2-b357d0dbab7e":{"description":"Request rejected","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"details":{"oneOf":[{"type":"object","required":["approvalId"],"properties":{"approvalId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"error.details.oneOf.0.approvalId","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.details.oneOf.1.items.[INDEX].code","typeLabel":"string"},"path":{"type":"array","items":{"oneOf":[{"type":"string","uniqueKey":"error.details.oneOf.1.items.[INDEX].path.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"number","uniqueKey":"error.details.oneOf.1.items.[INDEX].path.items.[INDEX].oneOf.1","typeLabel":"number"}],"uniqueKey":"error.details.oneOf.1.items.[INDEX].path.items.[INDEX]","typeLabel":"string | number"},"isRequired":true,"uniqueKey":"error.details.oneOf.1.items.[INDEX].path","typeLabel":"(string | number)[]"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.oneOf.1.items.[INDEX].message","typeLabel":"string"}},"required":["code","path","message"],"additionalProperties":false,"uniqueKey":"error.details.oneOf.1.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"error.details","typeLabel":"object | object[]"}},"required":["code","message","request_id","retryable"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","retryable":true,"details":{"approvalId":"\u003cstring>"}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"27e0441c-3034-43cb-b65b-8354133f522a":{"sessionCookie":{"type":"apiKey","in":"cookie","name":"__Secure-better-auth.session_token","description":"Better Auth session with selected organization. Mutations also require the trusted Origin header.","scopes":[]}}},"servers":{"5cf79b0f-3136-4019-b712-baaabf586852":{"url":"https://www.papers.bot/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"cookie","name":"__Secure-better-auth.session_token","description":"Better Auth session with selected organization. Mutations also require the trusted Origin header.","scopes":[]},"schema":{"title":"__Secure-better-auth.session_token","type":"string","description":"Better Auth session with selected organization. Mutations also require the trusted Origin header.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"sessionCookie","name":"__Secure-better-auth.session_token"}],"title":"sessionCookie"}]},"originalFileLocation":"openapi.json"},"subdomain":"papers","siteName":"Papers","title":"Issue a scoped workspace API key - Papers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-22T15:53:55.609Z","originalFileLocation":"api-reference/api-keys/issue-a-scoped-workspace-api-key.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=\"The token is shown only once. Unavailable during impersonation. Required scope: agents:write. Requires a human owner/admin session; agent API keys and delegated OAuth cannot administer the workspace.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Papers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/papers/cVyBph1BHOwg_Ach/_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=\"/docs/mintlify-assets/_mintlify/favicons/papers/cVyBph1BHOwg_Ach/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/papers/cVyBph1BHOwg_Ach/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/papers/cVyBph1BHOwg_Ach/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/papers/cVyBph1BHOwg_Ach/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/papers/cVyBph1BHOwg_Ach/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/papers/cVyBph1BHOwg_Ach/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/papers/cVyBph1BHOwg_Ach/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/papers/cVyBph1BHOwg_Ach/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Issue a scoped workspace API key - Papers\">\u003cmeta data-mint-head property=\"og:description\" content=\"The token is shown only once. Unavailable during impersonation. Required scope: agents:write. Requires a human owner/admin session; agent API keys and delegated OAuth cannot administer the workspace.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Papers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.papers.bot/docs/api-reference/api-keys/issue-a-scoped-workspace-api-key\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://papers.mintlify.site/docs/_mintlify/api/og/v2?division=API+keys\u0026amp;title=Issue+a+scoped+workspace+API+key\u0026amp;description=The+token+is+shown+only+once.+Unavailable+during+impersonation.+Required+scope%3A+agents%3Awrite.+Requires+a+human+owner%2Fadmin+session%3B+agent+API+keys+and+delegated\u0026amp;theme=e0697a16478105b1f570e090\u0026amp;signature=e6caebc73d4c082a6ca64c598f91fd0f21be5e1cb1bc27ad2e2b1c818240f668\">\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=\"Issue a scoped workspace API key - Papers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The token is shown only once. Unavailable during impersonation. Required scope: agents:write. Requires a human owner/admin session; agent API keys and delegated OAuth cannot administer the workspace.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://papers.mintlify.site/docs/_mintlify/api/og/v2?division=API+keys\u0026amp;title=Issue+a+scoped+workspace+API+key\u0026amp;description=The+token+is+shown+only+once.+Unavailable+during+impersonation.+Required+scope%3A+agents%3Awrite.+Requires+a+human+owner%2Fadmin+session%3B+agent+API+keys+and+delegated\u0026amp;theme=e0697a16478105b1f570e090\u0026amp;signature=e6caebc73d4c082a6ca64c598f91fd0f21be5e1cb1bc27ad2e2b1c818240f668\">\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=\"/docs/mintlify-assets/_mintlify/favicons/papers/cVyBph1BHOwg_Ach/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Papers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#166E3F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.papers.bot/docs/api-reference/api-keys/issue-a-scoped-workspace-api-key\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/api-keys/issue-a-scoped-workspace-api-key.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.papers.bot/#organization\",\"name\":\"Papers\",\"url\":\"https://www.papers.bot\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/papers/Lj6dvnd84QsF84tm/logo/light.svg?fit=max\u0026auto=format\u0026n=Lj6dvnd84QsF84tm\u0026q=85\u0026s=92cfb4e0bedd5b76fc6a17b86f6db9c0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.papers.bot/docs#website\",\"name\":\"Papers\",\"url\":\"https://www.papers.bot/docs\",\"publisher\":{\"@id\":\"https://www.papers.bot/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.papers.bot/docs/api-reference/api-keys/issue-a-scoped-workspace-api-key#webpage\",\"url\":\"https://www.papers.bot/docs/api-reference/api-keys/issue-a-scoped-workspace-api-key\",\"name\":\"Issue a scoped workspace API key\",\"description\":\"The token is shown only once. Unavailable during impersonation. Required scope: agents:write. Requires a human owner/admin session; agent API keys and delegated OAuth cannot administer the workspace.\",\"dateModified\":\"2026-09-22T15:53:55.609Z\",\"isPartOf\":{\"@id\":\"https://www.papers.bot/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.papers.bot/docs/api-reference/api-keys/issue-a-scoped-workspace-api-key#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.papers.bot/docs/api-reference/api-keys/issue-a-scoped-workspace-api-key#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API keys\",\"item\":\"https://www.papers.bot/docs/api-reference/api-keys/list-key-metadata\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Issue a scoped workspace API key\",\"item\":\"https://www.papers.bot/docs/api-reference/api-keys/issue-a-scoped-workspace-api-key\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.papers.bot/docs/api-reference/api-keys/issue-a-scoped-workspace-api-key#apireference\",\"headline\":\"Issue a scoped workspace API key\",\"name\":\"Issue a scoped workspace API key\",\"description\":\"The token is shown only once. Unavailable during impersonation. Required scope: agents:write. Requires a human owner/admin session; agent API keys and delegated OAuth cannot administer the workspace.\",\"url\":\"https://www.papers.bot/docs/api-reference/api-keys/issue-a-scoped-workspace-api-key\",\"mainEntityOfPage\":{\"@id\":\"https://www.papers.bot/docs/api-reference/api-keys/issue-a-scoped-workspace-api-key#webpage\"},\"dateModified\":\"2026-09-22T15:53:55.609Z\",\"publisher\":{\"@id\":\"https://www.papers.bot/#organization\"},\"isPartOf\":{\"@id\":\"https://www.papers.bot/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Papers\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Papers","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Identity","pages":[{"title":"Read the authenticated identity","deprecated":null,"version":null,"openapi":"/openapi.json get /me","href":"/api-reference/identity/read-the-authenticated-identity"},{"title":"Check configured providers and availability","deprecated":null,"version":null,"openapi":"/openapi.json get /capabilities","href":"/api-reference/identity/check-configured-providers-and-availability"}]},{"group":"Inboxes","pages":[{"title":"List accessible inboxes","deprecated":null,"version":null,"openapi":"/openapi.json get /inboxes","href":"/api-reference/inboxes/list-accessible-inboxes"},{"title":"Allocate an email address","deprecated":null,"version":null,"openapi":"/openapi.json post /inboxes","href":"/api-reference/inboxes/allocate-an-email-address"},{"title":"Read an inbox","deprecated":null,"version":null,"openapi":"/openapi.json get /inboxes/{id}","href":"/api-reference/inboxes/read-an-inbox"},{"title":"Archive or reactivate an inbox","deprecated":null,"version":null,"openapi":"/openapi.json patch /inboxes/{id}","href":"/api-reference/inboxes/archive-or-reactivate-an-inbox"},{"title":"List message summaries, newest first","deprecated":null,"version":null,"openapi":"/openapi.json get /inboxes/{id}/messages","href":"/api-reference/inboxes/list-message-summaries-newest-first"},{"title":"Send an email","deprecated":null,"version":null,"openapi":"/openapi.json post /inboxes/{id}/messages","href":"/api-reference/inboxes/send-an-email"}]},{"group":"Email","pages":[{"title":"Read message text and attachment metadata","deprecated":null,"version":null,"openapi":"/openapi.json get /messages/{id}","href":"/api-reference/email/read-message-text-and-attachment-metadata"},{"title":"Set read/unread state","deprecated":null,"version":null,"openapi":"/openapi.json patch /messages/{id}","href":"/api-reference/email/set-readunread-state"},{"title":"Reply using stored recipients and thread headers","deprecated":null,"version":null,"openapi":"/openapi.json post /messages/{id}/reply","href":"/api-reference/email/reply-using-stored-recipients-and-thread-headers"}]},{"group":"Attachments","pages":[{"title":"Issue a private 60-second attachment link","deprecated":null,"version":null,"openapi":"/openapi.json post /attachments/{id}/download-url","href":"/api-reference/attachments/issue-a-private-60-second-attachment-link"},{"title":"Download a private untrusted attachment","deprecated":null,"version":null,"openapi":"/openapi.json get /attachments/{id}/download","href":"/api-reference/attachments/download-a-private-untrusted-attachment"}]},{"group":"Phone numbers","pages":[{"title":"Read SMS summaries, newest first","deprecated":null,"version":null,"openapi":"/openapi.json get /phone-numbers/{id}/messages","href":"/api-reference/phone-numbers/read-sms-summaries-newest-first"},{"title":"Send an SMS from an assigned number","deprecated":null,"version":null,"openapi":"/openapi.json post /phone-numbers/{id}/messages","href":"/api-reference/phone-numbers/send-an-sms-from-an-assigned-number"},{"title":"Read an assigned number","deprecated":null,"version":null,"openapi":"/openapi.json get /phone-numbers/{id}","href":"/api-reference/phone-numbers/read-an-assigned-number"},{"title":"Permanently release a phone number","deprecated":null,"version":null,"openapi":"/openapi.json delete /phone-numbers/{id}","href":"/api-reference/phone-numbers/permanently-release-a-phone-number"},{"title":"List phone numbers and onboarding status","deprecated":null,"version":null,"openapi":"/openapi.json get /phone-numbers","href":"/api-reference/phone-numbers/list-phone-numbers-and-onboarding-status"},{"title":"Purchase a workspace phone number","deprecated":null,"version":null,"openapi":"/openapi.json post /phone-numbers","href":"/api-reference/phone-numbers/purchase-a-workspace-phone-number"},{"title":"Search available phone numbers at Papers retail prices","deprecated":null,"version":null,"openapi":"/openapi.json get /phone-numbers/available","href":"/api-reference/phone-numbers/search-available-phone-numbers-at-papers-retail-prices"}]},{"group":"SMS","pages":[{"title":"Read untrusted SMS text","deprecated":null,"version":null,"openapi":"/openapi.json get /sms/{id}","href":"/api-reference/sms/read-untrusted-sms-text"}]},{"group":"Events","pages":[{"title":"Read events in ascending order","deprecated":null,"version":null,"openapi":"/openapi.json get /events","href":"/api-reference/events/read-events-in-ascending-order"}]},{"group":"Operations","pages":[{"title":"Poll a mutation outcome","deprecated":null,"version":null,"openapi":"/openapi.json get /operations/{id}","href":"/api-reference/operations/poll-a-mutation-outcome"}]},{"group":"Approvals","pages":[{"title":"List recent approval requests","deprecated":null,"version":null,"openapi":"/openapi.json get /approvals","href":"/api-reference/approvals/list-recent-approval-requests"},{"title":"Approve an exact requested action","deprecated":null,"version":null,"openapi":"/openapi.json post /approvals/{id}/approve","href":"/api-reference/approvals/approve-an-exact-requested-action"},{"title":"Deny a requested action","deprecated":null,"version":null,"openapi":"/openapi.json post /approvals/{id}/deny","href":"/api-reference/approvals/deny-a-requested-action"}]},{"group":"API keys","pages":[{"title":"List key metadata","description":"Required scope: agents:read. Requires a human owner/admin session; agent API keys and delegated OAuth cannot administer the workspace.","deprecated":null,"version":null,"openapi":"/openapi.json get /api-keys","href":"/api-reference/api-keys/list-key-metadata"},{"title":"Issue a scoped workspace API key","deprecated":null,"version":null,"openapi":"/openapi.json post /api-keys","href":"/api-reference/api-keys/issue-a-scoped-workspace-api-key"},{"title":"Revoke an API key","description":"Required scope: agents:write. Requires a human owner/admin session; agent API keys and delegated OAuth cannot administer the workspace.","deprecated":null,"version":null,"openapi":"/openapi.json delete /api-keys/{id}","href":"/api-reference/api-keys/revoke-an-api-key"}]},{"group":"Connections","pages":[{"title":"Set your OAuth connection daily send limits","deprecated":null,"version":null,"openapi":"/openapi.json patch /connections/{id}/limits","href":"/api-reference/connections/set-your-oauth-connection-daily-send-limits"},{"title":"List your OAuth grants in the selected workspace","deprecated":null,"version":null,"openapi":"/openapi.json get /connections","href":"/api-reference/connections/list-your-oauth-grants-in-the-selected-workspace"},{"title":"Revoke your OAuth grant","deprecated":null,"version":null,"openapi":"/openapi.json delete /connections/{id}","href":"/api-reference/connections/revoke-your-oauth-grant"}]},{"group":"Webhook endpoints","pages":[{"title":"List webhook delivery history","deprecated":null,"version":null,"openapi":"/openapi.json get /webhook-endpoints/{id}/deliveries","href":"/api-reference/webhook-endpoints/list-webhook-delivery-history"},{"title":"Read webhook delivery attempts","deprecated":null,"version":null,"openapi":"/openapi.json get /webhook-endpoints/{id}/deliveries/{deliveryId}","href":"/api-reference/webhook-endpoints/read-webhook-delivery-attempts"},{"title":"List workspace webhook endpoints","deprecated":null,"version":null,"openapi":"/openapi.json get /webhook-endpoints","href":"/api-reference/webhook-endpoints/list-workspace-webhook-endpoints"},{"title":"Configure an inactive webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /webhook-endpoints","href":"/api-reference/webhook-endpoints/configure-an-inactive-webhook-endpoint"},{"title":"Delete webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json delete /webhook-endpoints/{id}","href":"/api-reference/webhook-endpoints/delete-webhook-endpoint"},{"title":"Update or enable a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json patch /webhook-endpoints/{id}","href":"/api-reference/webhook-endpoints/update-or-enable-a-webhook-endpoint"},{"title":"Rotate the webhook signing secret","deprecated":null,"version":null,"openapi":"/openapi.json post /webhook-endpoints/{id}/rotate-secret","href":"/api-reference/webhook-endpoints/rotate-the-webhook-signing-secret"}]},{"group":"Workspace","pages":[{"title":"Monthly workspace usage and reported SMS costs","deprecated":null,"version":null,"openapi":"/openapi.json get /workspace/usage","href":"/api-reference/workspace/monthly-workspace-usage-and-reported-sms-costs"},{"title":"Read workspace limits and current UTC-day usage","deprecated":null,"version":null,"openapi":"/openapi.json get /workspace/policy","href":"/api-reference/workspace/read-workspace-limits-and-current-utc-day-usage"},{"title":"Update workspace limits","deprecated":null,"version":null,"openapi":"/openapi.json patch /workspace/policy","href":"/api-reference/workspace/update-workspace-limits"}]},{"group":"Billing","pages":[{"title":"Read plan, prepaid balance and financial transactions","deprecated":null,"version":null,"openapi":"/openapi.json get /billing","href":"/api-reference/billing/read-plan-prepaid-balance-and-financial-transactions"},{"title":"Create a plan, phone rental or prepaid top-up checkout","deprecated":null,"version":null,"openapi":"/openapi.json post /billing/checkout","href":"/api-reference/billing/create-a-plan-phone-rental-or-prepaid-top-up-checkout"},{"title":"Open Stripe billing portal","deprecated":null,"version":null,"openapi":"/openapi.json post /billing/portal","href":"/api-reference/billing/open-stripe-billing-portal"},{"title":"Upgrade now or schedule a downgrade at renewal","deprecated":null,"version":null,"openapi":"/openapi.json post /billing/plan","href":"/api-reference/billing/upgrade-now-or-schedule-a-downgrade-at-renewal"},{"title":"Opt in to automatic prepaid top-ups with a monthly ceiling","deprecated":null,"version":null,"openapi":"/openapi.json patch /billing/auto-topup","href":"/api-reference/billing/opt-in-to-automatic-prepaid-top-ups-with-a-monthly-ceiling"}]}]}]},"basePath":"","title":"Issue a scoped workspace API key - Papers","buildId":"dpl_3pZeXn3XukjzFRgAX73A7GNDfRJ1","deploymentId":"dpl_3pZeXn3XukjzFRgAX73A7GNDfRJ1","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CW3yP2DK.js","utils-BN0nty2W.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C8_MydSG.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bsl5xDMQ.js","snippetPresets-DYv9OBej.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-CBlOSKZG.js","ApiExamples-9OnYPrVf.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-xr67xWGO.js","shallow-DO1aDdBF.js","getApiPlaygroundDisplay-o7cLzFL-.js","CodeSnippet-CGr2yOA8.js","CodeSnippets-CzBbqPNh.js","getPastedJson-dpi9sn5Y.js","icon-aIWHt8Pn.js","MethodPill-Bv2zLsGY.js","DuplicateIcon-DxFSz0J6.js","createIcon-uDNv6jwj.js","DynamicMarkdown-C91yhnNP.js","SectionHeading-DG_xjOLR.js","axios-vUo_bRtp.js","Markdown-B4M_Eo1P.js","clsx-DShopWo_.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BX6wab7q.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-48h67xm_.js"]}