Your personal API token authenticates all requests to the Codegen API. This token is tied to your user account and inherits your permissions within organizations.
Most API endpoints require an organization ID to specify which organization’s resources you want to access. You can find your organization ID in the developer settings.
from codegen import Agent# Initialize with your credentialsagent = Agent(org_id="YOUR_ORG_ID", token="YOUR_API_TOKEN")# The SDK handles authentication automaticallytask = agent.run(prompt="Fix the bug in user authentication")
Was this page helpful?
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Codegen","colors":{"primary":"#a277ff","light":"#a277ff","dark":"#a277ff"},"logo":{"light":"https://cdn.prod.website-files.com/67070304751b9b01bf6a161c/679bcf45bf55446746125835_Codegen_Logomark_Light.svg","dark":"https://cdn.prod.website-files.com/67070304751b9b01bf6a161c/679bcf45a3e32761c42b324b_Codegen_Logomark_Dark.svg"},"favicon":"/favicon.svg","appearance":{"default":"dark"},"background":{"decoration":"gradient"},"navbar":{"primary":{"type":"button","label":"GitHub","href":"https://github.com/codegen-sh/codegen-sdk"}},"footer":{"socials":{"x":"https://x.com/codegen","linkedin":"https://linkedin.com/company/codegen-dot-com"}},"seo":{"metatags":{"og:site_name":"Codegen","og:title":"Codegen - The SWE that Never Sleeps","og:description":"Code agents accessible via API, Slack, Linear, Github, and more.","og:url":"https://docs.codegen.com","og:locale":"en_US","og:logo":"https://i.imgur.com/f4OVOqI.png","article:publisher":"Codegen, Inc.","twitter:site":"@codegen"},"indexing":"navigable"},"integrations":{"posthog":{"apiKey":"phc_GLxaINoQJnuyCyxDmTciQqzdKBYFVDkY7bRBO4bDdso"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"codegeninc","hasAudioNarration":false,"actualSubdomain":"codegeninc","customDomains":["docs.codegen.com"],"gitSource":{"type":"github","owner":"codegen-sh","repo":"codegen","deployBranch":"develop","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21e64594a5dc2e6daf384d","collectionId":"5965b23c-2ac3-41ec-ba05-42536575d939","schemaVersion":"v2"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"REMOVE_BRANDING":{"status":"DISABLED"}},"buildId":"6a21e64594a5dc2e6daf384d:success","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Documentation","count":43},{"language":"default","tag":"API Reference","count":28},{"language":"default","tag":"Endpoints","count":25},{"language":"default","tag":"Integrations","count":14},{"language":"default","tag":"Guides","count":12},{"language":"default","tag":"Overview","count":7},{"language":"default","tag":"Settings","count":7},{"language":"default","tag":"agents","count":7},{"language":"default","tag":"Sandboxes","count":6},{"language":"default","tag":"organizations","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"editor-agent-model-picker","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":"billing-updated-9-15","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"prism.css","content":":root{--font-jetbrains-mono:Menlo, Monaco, \"Courier New\", monospace!important}pre[class*=language-]{text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.5;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-hyphens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}code,code[class*=language-],kbd,pre,pre[class*=language-],samp{font-family:Menlo,Monaco,\"Andale Mono\",\"Ubuntu Mono\",monospace!important;--font-jetbrains-mono:Consolas, Monaco, \"Andale Mono\", \"Ubuntu Mono\",\n\t\tmonospace!important;font-weight:500!important}code[class*=language-] ::-moz-selection,code[class*=language-]::-moz-selection,pre[class*=language-] ::-moz-selection,pre[class*=language-]::-moz-selection{text-shadow:none;background:#362d45}code[class*=language-] ::selection,code[class*=language-]::selection,pre[class*=language-] ::selection,pre[class*=language-]::selection{text-shadow:none;background:#362d45}@media print{code[class*=language-],pre[class*=language-]{text-shadow:none}}pre[class*=language-]{padding:1em;margin:.5em 0;overflow:auto}:not(pre)>code[class*=language-],pre[class*=language-]{color:#fff}:not(pre)>code[class*=language-]{padding:.1em;border-radius:.3em;white-space:normal}.language-python .language-bash{background-color:#15141b!important;font-family:Consolas,Monaco,\"Andale Mono\",\"Ubuntu Mono\",monospace!important;font-weight:600!important;font-size:16px!important}.dark\\:bg-codeblock:is(.dark *){background-color:#15141b!important}.dark\\:ring-gray-800\\/50:is(.dark *){--tw-ring-color:#15141b!important}.codeblock-dark{background-color:#15141b!important;color:#edecee!important;font-size:20px!important}.dark .prose{color:#edecee!important;font-size:16px!important}.dark .prose p code,.dark .prose ul code{color:#ffca85!important}.dark .prose p code .comment,.dark .prose ul code .comment,.token.comment,code .token.comment,pre .token.comment{color:#6d6d6d!important}.prose a,.token.attr-name,.token.constant,.token.keyword,.token.operator,.token.punctuation,.token.tag,.token.variable{color:#a277ff!important}.token.inserted,.token.string{color:#61ffca!important}.token.changed,.token.function{color:#ffca85!important}.token.deleted{color:#ff6767!important}.language-bash,.token.builtin,.token.property{color:#ffca85!important}.token.class-name{color:#82e2ff!important}.token.bold,.token.important{font-weight:700!important}.token.italic{font-style:italic!important}.language-bash .token{color:#ffca85!important;font-weight:700!important}"},{"filePath":"style.css","content":".dark .bg-codeblock{background-color:#15141b!important}"}],"page":{"pagePath":"api-reference/authentication","slug":"/api-reference/authentication","pageMetadata":{"title":"Authentication","sidebarTitle":"Authentication","icon":"key","description":null,"href":"/api-reference/authentication"},"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={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{Card,CodeBlock,Heading}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`All Codegen API endpoints require authentication using Bearer tokens. You’ll need both an API token and your organization ID to get started.`}),`\n`,_jsx(Heading,{level:`2`,id:`get-your-credentials`,children:`Get Your Credentials`}),`\n`,_jsx(Card,{title:`Get API Token \u0026 Organization ID`,icon:`key`,href:`https://codegen.com/token`,children:_jsx(_components.p,{children:`Visit the developer settings to generate your API token and find your\norganization ID.`})}),`\n`,_jsx(Heading,{level:`2`,id:`required-information`,children:`Required Information`}),`\n`,_jsx(Heading,{level:`3`,id:`api-token`,children:`API Token`}),`\n`,_jsx(_components.p,{children:`Your personal API token authenticates all requests to the Codegen API. This token is tied to your user account and inherits your permissions within organizations.`}),`\n`,_jsx(Heading,{level:`3`,id:`organization-id`,children:`Organization ID`}),`\n`,_jsx(_components.p,{children:`Most API endpoints require an organization ID to specify which organization’s resources you want to access. You can find your organization ID in the developer settings.`}),`\n`,_jsx(Heading,{level:`2`,id:`using-your-credentials`,children:`Using Your Credentials`}),`\n`,_jsx(Heading,{level:`3`,id:`rest-api`,children:`REST API`}),`\n`,_jsx(_components.p,{children:`Include your API token in the Authorization header for all requests:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_TOKEN\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.codegen.com/v1/organizations/YOUR_ORG_ID/agent/run\"`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`python-sdk`,children:`Python SDK`}),`\n`,_jsx(_components.p,{children:`The Python SDK makes authentication simple:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` codegen `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Agent`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Initialize with your credentials`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`agent `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Agent(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`org_id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"YOUR_ORG_ID\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`token`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"YOUR_API_TOKEN\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# The SDK handles authentication automatically`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`task `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` agent.run(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`prompt`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Fix the bug in user authentication\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\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":{"config":{},"pageMetadata":{"title":"Authentication","sidebarTitle":"Authentication","icon":"key","description":null,"href":"/api-reference/authentication"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Get Your Credentials","slug":"get-your-credentials","depth":2,"children":[]},{"title":"Required Information","slug":"required-information","depth":2,"children":[{"title":"API Token","slug":"api-token","depth":3,"children":[]},{"title":"Organization ID","slug":"organization-id","depth":3,"children":[]}]},{"title":"Using Your Credentials","slug":"using-your-credentials","depth":2,"children":[{"title":"REST API","slug":"rest-api","depth":3,"children":[]},{"title":"Python SDK","slug":"python-sdk","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"codegeninc","siteName":"Codegen","title":"Codegen - The SWE that Never Sleeps","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T02:47:23.359Z","originalFileLocation":"api-reference/authentication.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=\"dark\"}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=\"application-name\" content=\"Codegen\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/codegeninc/_lRXFMT4OI26HnBz/_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/codegeninc/_lRXFMT4OI26HnBz/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/codegeninc/_lRXFMT4OI26HnBz/_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/codegeninc/_lRXFMT4OI26HnBz/_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/codegeninc/_lRXFMT4OI26HnBz/_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/codegeninc/_lRXFMT4OI26HnBz/_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/codegeninc/_lRXFMT4OI26HnBz/_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/codegeninc/_lRXFMT4OI26HnBz/_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/codegeninc/_lRXFMT4OI26HnBz/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Codegen - The SWE that Never Sleeps\">\u003cmeta data-mint-head property=\"og:description\" content=\"Code agents accessible via API, Slack, Linear, Github, and more.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Codegen\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.codegen.com/api-reference/authentication\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://codegeninc.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Authentication\u0026amp;theme=b0c2dc70837d827c69bc9629\u0026amp;signature=6fc6a6e3f5a9747a7e3406988b75640721872b0f538d152dd1c96f568e698cfd\">\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=\"Codegen - The SWE that Never Sleeps\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Code agents accessible via API, Slack, Linear, Github, and more.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://codegeninc.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Authentication\u0026amp;theme=b0c2dc70837d827c69bc9629\u0026amp;signature=6fc6a6e3f5a9747a7e3406988b75640721872b0f538d152dd1c96f568e698cfd\">\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/codegeninc/_lRXFMT4OI26HnBz/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Codegen\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#a277ff\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"og:logo\" content=\"https://i.imgur.com/f4OVOqI.png\">\u003cmeta data-mint-head name=\"article:publisher\" content=\"Codegen, Inc.\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.codegen.com/api-reference/authentication\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/authentication.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.codegen.com/#organization\",\"name\":\"Codegen\",\"url\":\"https://docs.codegen.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://cdn.prod.website-files.com/67070304751b9b01bf6a161c/679bcf45bf55446746125835_Codegen_Logomark_Light.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.codegen.com#website\",\"name\":\"Codegen\",\"url\":\"https://docs.codegen.com\",\"publisher\":{\"@id\":\"https://docs.codegen.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.codegen.com/api-reference/authentication#webpage\",\"url\":\"https://docs.codegen.com/api-reference/authentication\",\"name\":\"Authentication\",\"dateModified\":\"2026-01-07T02:47:23.359Z\",\"isPartOf\":{\"@id\":\"https://docs.codegen.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.codegen.com/api-reference/authentication#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.codegen.com/api-reference/authentication#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.codegen.com/api-reference/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Authentication\",\"item\":\"https://docs.codegen.com/api-reference/authentication\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.codegen.com/api-reference/authentication#article\",\"headline\":\"Authentication\",\"name\":\"Authentication\",\"url\":\"https://docs.codegen.com/api-reference/authentication\",\"mainEntityOfPage\":{\"@id\":\"https://docs.codegen.com/api-reference/authentication#webpage\"},\"dateModified\":\"2026-01-07T02:47:23.359Z\",\"publisher\":{\"@id\":\"https://docs.codegen.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.codegen.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Codegen\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Codegen","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction/overview"}]},{"tab":"API Reference","groups":[{"group":"Guides","pages":[{"title":"Codegen API","sidebarTitle":"Overview","icon":"code","description":null,"href":"/api-reference/overview"},{"title":"Authentication","sidebarTitle":"Authentication","icon":"key","href":"/api-reference/authentication"},{"title":"Retrieving Traces","sidebarTitle":"Retrieving Traces","icon":"list","iconType":"solid","description":null,"href":"/api-reference/agent-run-logs"}]},{"group":"Endpoints","pages":[{"group":"users","pages":[{"title":"Get Users","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json get /v1/organizations/{org_id}/users","href":"/api-reference/users/get-users"},{"title":"Get User","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json get /v1/organizations/{org_id}/users/{user_id}","href":"/api-reference/users/get-user"},{"title":"Get Current User Info","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json get /v1/users/me","href":"/api-reference/users/get-current-user-info"}]},{"group":"agents","pages":[{"title":"Create Agent Run","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json post /v1/organizations/{org_id}/agent/run","href":"/api-reference/agents/create-agent-run"},{"title":"Get Agent Run","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json get /v1/organizations/{org_id}/agent/run/{agent_run_id}","href":"/api-reference/agents/get-agent-run"},{"title":"List Agent Runs","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json get /v1/organizations/{org_id}/agent/runs","href":"/api-reference/agents/list-agent-runs"},{"title":"Resume Agent Run","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json post /v1/organizations/{org_id}/agent/run/resume","href":"/api-reference/agents/resume-agent-run"},{"title":"Ban All Checks For Agent Run","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json post /v1/organizations/{org_id}/agent/run/ban","href":"/api-reference/agents/ban-all-checks-for-agent-run"},{"title":"Unban All Checks For Agent Run","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json post /v1/organizations/{org_id}/agent/run/unban","href":"/api-reference/agents/unban-all-checks-for-agent-run"},{"title":"Remove Codegen From Pr","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json post /v1/organizations/{org_id}/agent/run/remove-from-pr","href":"/api-reference/agents/remove-codegen-from-pr"}]},{"group":"repositories","pages":[{"title":"Get Repositories","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json get /v1/organizations/{org_id}/repos","href":"/api-reference/repositories/get-repositories"},{"title":"Get Check Suite Settings","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json get /v1/organizations/{org_id}/repos/check-suite-settings","href":"/api-reference/repositories/get-check-suite-settings"},{"title":"Update Check Suite Settings","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json put /v1/organizations/{org_id}/repos/check-suite-settings","href":"/api-reference/repositories/update-check-suite-settings"}]},{"group":"pull-requests","pages":[{"title":"Edit Pull Request Simple","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json patch /v1/organizations/{org_id}/prs/{pr_id}","href":"/api-reference/pull-requests/edit-pull-request-simple"},{"title":"Edit Pull Request","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json patch /v1/organizations/{org_id}/repos/{repo_id}/prs/{pr_id}","href":"/api-reference/pull-requests/edit-pull-request"}]},{"group":"integrations","pages":[{"title":"Get Organization Integrations Endpoint","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json get /v1/organizations/{org_id}/integrations","href":"/api-reference/integrations/get-organization-integrations-endpoint"}]},{"group":"setup-commands","pages":[{"title":"Generate Setup Commands","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json post /v1/organizations/{org_id}/setup-commands/generate","href":"/api-reference/setup-commands/generate-setup-commands"}]},{"group":"organizations","pages":[{"title":"Get Organizations","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json get /v1/organizations","href":"/api-reference/organizations/get-organizations"},{"title":"Get Mcp Providers","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json get /v1/mcp-providers","href":"/api-reference/organizations/get-mcp-providers"},{"title":"Get Oauth Token Status","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json get /v1/oauth/tokens/status","href":"/api-reference/organizations/get-oauth-token-status"},{"title":"Revoke Oauth Token","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json post /v1/oauth/tokens/revoke","href":"/api-reference/organizations/revoke-oauth-token"}]},{"group":"sandbox","pages":[{"title":"Analyze Sandbox Logs","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json post /v1/organizations/{org_id}/sandbox/{sandbox_id}/analyze-logs","href":"/api-reference/sandbox/analyze-sandbox-logs"}]},{"group":"cli-rules","pages":[{"title":"Get Cli Rules","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json get /v1/organizations/{org_id}/cli/rules","href":"/api-reference/cli-rules/get-cli-rules"}]},{"group":"slack-connect","pages":[{"title":"Generate Slack Connect Token Endpoint","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json post /v1/slack-connect/generate-token","href":"/api-reference/slack-connect/generate-slack-connect-token-endpoint"}]},{"group":"agents-alpha","pages":[{"title":"Get Agent Run Logs","deprecated":null,"version":null,"openapi":"api-reference/openapi3.json get /v1/alpha/organizations/{org_id}/agent/run/{agent_run_id}/logs","href":"/api-reference/agents-alpha/get-agent-run-logs"}]}]}]}]},"title":"Codegen - The SWE that Never Sleeps","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":[],"chunks":[]}