Production deployment guide for teams integrating the Noonum REST API and MCP server. Covers auth, key hygiene, error handling, retries, and a pre-launch checklist.
Authentication and base URLs
Noonum runs a single production environment. Point REST API integrations at
https://api.noonum.ai/v1 and MCP clients at https://mcp.noonum.ai/mcp. Both
authenticate with a Bearer token. The full setup (the Authorization header and how to
request a key) is on the Authentication page.The Noonum API key is a static, long-lived credential that requires no round-trip, which
suits server-side jobs, cron, ETL, and other services that run without a human present.
Interactive MCP clients that sign users in are set up differently. See
MCP client setup.
Key hygiene
Treat an API key like a password. It grants full access to your account.
Never embed API keys in client-side code. Browser bundles, mobile apps, and
anything shipped to a user device are inspectable. A key placed there is effectively
public. Keep keys server-side only.
Inject secrets at runtime, from environment variables or a secrets manager. Do not
commit keys to source control, logs, screenshots, or support tickets.
Use separate keys per environment or service where possible, so one can be revoked
without disrupting the others.
Rotate keys on a schedule and immediately if one may have leaked. To rotate or
revoke a key, contact support at hello@noonum.com.
If a key is exposed (committed, logged, or shared), assume it is compromised and request
a rotation from support right away.
Error handling
Build your integration to react to HTTP status codes, not just the response body. The full
status-code reference lives in the
REST integration tutorial. For
production, these are the behaviors that matter:
401 Unauthorized: the request wasn’t authenticated, from a missing or malformed
Authorization header, an invalid/revoked/rotated key, or an inactive account. Surface
the failure and check the key. Don’t retry, since the same bad credential will
keep failing. If the key was rotated, update your secret store.
423 Locked from POST /strategies/{strategyId}/submit: a previous run of the
strategy is still in progress. Wait for it to finish, then submit again.
429 Too Many Requests from POST /strategies/{strategyId}/submit or
POST /strategies/{strategyId}/historical-data: your plan doesn’t have enough credits
left in the current period. Each run, live or historical, uses one credit. A failed run
is not charged. Don’t retry, since the request keeps failing until your credits refill.
GET /usage returns the credits you have left (remaining) and
when they refill (refills_at). To get more credits, contact support.
Other 4xx codes, such as 400 and 404: a problem with the request itself. Fix it;
don’t retry unchanged.
5xx: a transient server-side error. Retry with backoff, as below.
Always read the response body for a machine-readable error and log it (with secrets
redacted) so failures are diagnosable in production.
Credits and retries
Your plan’s credits limit how many strategy runs you can start in each period. Design
clients to retry transient failures and to stop on errors that a retry can’t fix.
Retry on 5xx only. A 4xx won’t succeed on an immediate retry, so handle it as
described in Error handling.
Use exponential backoff with jitter. Increase the wait between attempts (for
example 1s, 2s, 4s, 8s) and add a small random offset so concurrent clients don’t
retry in lockstep.
Honor Retry-After when present. If a 503 response includes a Retry-After
header, wait at least that long before retrying.
Cap retries (for example 4 to 5 attempts), then fail rather than hammering
the REST API indefinitely.
Smooth your own request rate. Add client-side concurrency limits and spread bulk
work over time.
All requests target https://api.noonum.ai/v1 (REST API) or https://mcp.noonum.ai/mcp (MCP server).
Every request that uses an API key sends it as Authorization: Bearer <api-key>.
No API key is present in any client-side bundle, mobile app, or repository.
Keys are loaded from environment variables or a secrets manager at runtime.
A key rotation path is documented and known to the team.
401 handling surfaces the failure and checks the credential.
429 handling stops submitting runs and reports that your plan’s credits ran out.
Retry logic covers 5xx only, uses exponential backoff with jitter, honors Retry-After, and is capped.
Errors and status codes are logged (with secrets redacted) for production diagnosis.
Timeouts and concurrency limits are set so a slow dependency can’t stall your app.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Noonum Developers","colors":{"primary":"#283593","light":"#5C6BC0","dark":"#1C2567"},"logo":{"light":"https://mintcdn.com/noonum/hjqoeqYecXinFmHz/logo/light.svg?fit=max\u0026auto=format\u0026n=hjqoeqYecXinFmHz\u0026q=85\u0026s=188c3655522bcd415399dee02c626765","dark":"https://mintcdn.com/noonum/hjqoeqYecXinFmHz/logo/dark.svg?fit=max\u0026auto=format\u0026n=hjqoeqYecXinFmHz\u0026q=85\u0026s=2b5f7ab1e8b3769febd4b2cd98d29769"},"favicon":{"light":"https://mintcdn.com/noonum/hjqoeqYecXinFmHz/logo/favicon-light.svg?fit=max\u0026auto=format\u0026n=hjqoeqYecXinFmHz\u0026q=85\u0026s=10bb168c3f41043a4e3888e7a175fd08","dark":"https://mintcdn.com/noonum/hjqoeqYecXinFmHz/logo/favicon-dark.svg?fit=max\u0026auto=format\u0026n=hjqoeqYecXinFmHz\u0026q=85\u0026s=9a697ddc2053562db08f7fd0e560e242"},"api":{"examples":{"languages":["curl","python","javascript","go"]},"mdx":{"server":"https://api.noonum.ai"}},"appearance":{"default":"system"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://noonum.ai","label":"noonum.ai"},{"href":"mailto:hello@noonum.com","label":"Support"}],"primary":{"type":"github","href":"https://github.com/noonum"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/noonum","x":"https://x.com/noonum","github":"https://github.com/noonum"},"links":[{"header":"Noonum, Inc.","items":[{"label":"Privacy Policy","href":"https://noonum.ai/privacy"},{"label":"Terms of Service","href":"https://noonum.ai/terms"},{"label":"Contact","href":"mailto:hello@noonum.com"}]}]},"seo":{"metatags":{"canonical":"https://docs.noonum.ai","og:locale":"en_US","twitter:site":"@noonum"}},"fonts":{"heading":{"family":"Montserrat"},"body":{"family":"Inter"}},"icons":{"library":"fontawesome"},"integrations":{"telemetry":{"enabled":false}},"contextual":{"options":["copy","chatgpt","claude","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"noonum","hasAudioNarration":false,"actualSubdomain":"noonum","customDomains":["docs.noonum.ai"],"gitSource":{"type":"github","owner":"noonum","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"issues":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af627a4701afd0a5b2f55b6","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":86},{"language":"default","tag":"Endpoints","count":84},{"language":"default","tag":"UserStrategies","count":38},{"language":"default","tag":"Documentation","count":25},{"language":"default","tag":"Helper","count":16},{"language":"default","tag":"Guides","count":12},{"language":"default","tag":"Portfolios","count":10},{"language":"default","tag":"PremadeStrategies","count":8},{"language":"default","tag":"Get started","count":6},{"language":"default","tag":"Segments","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"v1/deployment/overview","slug":"/v1/deployment/overview","pageMetadata":{"title":"Going to production","description":"Production deployment guide for teams integrating the Noonum REST API and MCP server. Covers auth, key hygiene, error handling, retries, and a pre-launch checklist.","icon":"cloud-arrow-up","href":"/v1/deployment/overview"},"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: \"Production deployment guide for teams integrating the Noonum REST API and MCP server. Covers auth, key hygiene, error handling, retries, and a pre-launch checklist.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`authentication-and-base-urls`,children:`Authentication and base URLs`}),`\n`,_jsxs(_components.p,{children:[`Noonum runs a single production environment. Point REST API integrations at\n`,_jsx(_components.code,{children:`https://api.noonum.ai/v1`}),` and MCP clients at `,_jsx(_components.code,{children:`https://mcp.noonum.ai/mcp`}),`. Both\nauthenticate with a Bearer token. The full setup (the `,_jsx(_components.code,{children:`Authorization`}),` header and how to\nrequest a key) is on the `,_jsx(_components.a,{href:`/v1/getting-started/authentication`,children:`Authentication`}),` page.`]}),`\n`,_jsxs(_components.p,{children:[`The Noonum API key is a static, long-lived credential that requires no round-trip, which\nsuits server-side jobs, cron, ETL, and other services that run without a human present.\nInteractive MCP clients that sign users in are set up differently. See\n`,_jsx(_components.a,{href:`/base/agentic/mcp-client-setup`,children:`MCP client setup`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`key-hygiene`,children:`Key hygiene`}),`\n`,_jsx(_components.p,{children:`Treat an API key like a password. It grants full access to your account.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Never embed API keys in client-side code.`}),` Browser bundles, mobile apps, and\nanything shipped to a user device are inspectable. A key placed there is effectively\npublic. Keep keys server-side only.`]}),`\n`,_jsx(_components.li,{children:`Inject secrets at runtime, from environment variables or a secrets manager. Do not\ncommit keys to source control, logs, screenshots, or support tickets.`}),`\n`,_jsx(_components.li,{children:`Use separate keys per environment or service where possible, so one can be revoked\nwithout disrupting the others.`}),`\n`,_jsxs(_components.li,{children:[`Rotate keys on a schedule and immediately if one may have leaked. To rotate or\nrevoke a key, contact support at `,_jsx(_components.a,{href:`mailto:hello@noonum.com`,children:`hello@noonum.com`}),`.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`If a key is exposed (committed, logged, or shared), assume it is compromised and request\na rotation from support right away.`})}),`\n`,_jsx(Heading,{level:`2`,id:`error-handling`,children:`Error handling`}),`\n`,_jsxs(_components.p,{children:[`Build your integration to react to HTTP status codes, not just the response body. The full\nstatus-code reference lives in the\n`,_jsx(_components.a,{href:`/v1/guides/rest-integration#handling-errors`,children:`REST integration tutorial`}),`. For\nproduction, these are the behaviors that matter:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`401 Unauthorized`}),`: the request wasn’t authenticated, from a missing or malformed\n`,_jsx(_components.code,{children:`Authorization`}),` header, an invalid/revoked/rotated key, or an inactive account. Surface\nthe failure and check the key. Don’t retry, since the same bad credential will\nkeep failing. If the key was rotated, update your secret store.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`423 Locked`}),` from `,_jsx(_components.code,{children:`POST /strategies/{strategyId}/submit`}),`: a previous run of the\nstrategy is still in progress. Wait for it to finish, then submit again.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`429 Too Many Requests`}),` from `,_jsx(_components.code,{children:`POST /strategies/{strategyId}/submit`}),` or\n`,_jsx(_components.code,{children:`POST /strategies/{strategyId}/historical-data`}),`: your plan doesn’t have enough credits\nleft in the current period. Each run, live or historical, uses one credit. A failed run\nis not charged. Don’t retry, since the request keeps failing until your credits refill.\n`,_jsx(_components.code,{children:`GET /usage`}),` returns the credits you have left (`,_jsx(_components.code,{children:`remaining`}),`) and\nwhen they refill (`,_jsx(_components.code,{children:`refills_at`}),`). To get more credits, contact support.`]}),`\n`,_jsxs(_components.li,{children:[`Other `,_jsx(_components.code,{children:`4xx`}),` codes, such as `,_jsx(_components.code,{children:`400`}),` and `,_jsx(_components.code,{children:`404`}),`: a problem with the request itself. Fix it;\ndon’t retry unchanged.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`5xx`}),`: a transient server-side error. Retry with backoff, as below.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Always read the response body for a machine-readable error and log it (with secrets\nredacted) so failures are diagnosable in production.`}),`\n`,_jsx(Heading,{level:`2`,id:`credits-and-retries`,children:`Credits and retries`}),`\n`,_jsx(_components.p,{children:`Your plan’s credits limit how many strategy runs you can start in each period. Design\nclients to retry transient failures and to stop on errors that a retry can’t fix.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Retry on `,_jsx(_components.code,{children:`5xx`}),` only. A `,_jsx(_components.code,{children:`4xx`}),` won’t succeed on an immediate retry, so handle it as\ndescribed in `,_jsx(_components.a,{href:`#error-handling`,children:`Error handling`}),`.`]}),`\n`,_jsx(_components.li,{children:`Use exponential backoff with jitter. Increase the wait between attempts (for\nexample 1s, 2s, 4s, 8s) and add a small random offset so concurrent clients don’t\nretry in lockstep.`}),`\n`,_jsxs(_components.li,{children:[`Honor `,_jsx(_components.code,{children:`Retry-After`}),` when present. If a `,_jsx(_components.code,{children:`503`}),` response includes a `,_jsx(_components.code,{children:`Retry-After`}),`\nheader, wait at least that long before retrying.`]}),`\n`,_jsx(_components.li,{children:`Cap retries (for example 4 to 5 attempts), then fail rather than hammering\nthe REST API indefinitely.`}),`\n`,_jsx(_components.li,{children:`Smooth your own request rate. Add client-side concurrency limits and spread bulk\nwork over time.`}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`attempt 1 → fail (503) → wait ~1s + jitter`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`attempt 2 → fail (503) → wait ~2s + jitter`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`attempt 3 → fail (5xx) → wait ~4s + jitter`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`attempt 4 → success`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`pre-launch-checklist`,children:`Pre-launch checklist`}),`\n`,_jsx(_components.p,{children:`Before pointing production traffic at Noonum:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`All requests target `,_jsx(_components.code,{children:`https://api.noonum.ai/v1`}),` (REST API) or `,_jsx(_components.code,{children:`https://mcp.noonum.ai/mcp`}),` (MCP server).`]}),`\n`,_jsxs(_components.li,{children:[`Every request that uses an API key sends it as `,_jsx(_components.code,{children:`Authorization: Bearer \u003capi-key>`}),`.`]}),`\n`,_jsx(_components.li,{children:`No API key is present in any client-side bundle, mobile app, or repository.`}),`\n`,_jsx(_components.li,{children:`Keys are loaded from environment variables or a secrets manager at runtime.`}),`\n`,_jsx(_components.li,{children:`A key rotation path is documented and known to the team.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`401`}),` handling surfaces the failure and checks the credential.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`429`}),` handling stops submitting runs and reports that your plan’s credits ran out.`]}),`\n`,_jsxs(_components.li,{children:[`Retry logic covers `,_jsx(_components.code,{children:`5xx`}),` only, uses exponential backoff with jitter, honors `,_jsx(_components.code,{children:`Retry-After`}),`, and is capped.`]}),`\n`,_jsx(_components.li,{children:`Errors and status codes are logged (with secrets redacted) for production diagnosis.`}),`\n`,_jsx(_components.li,{children:`Timeouts and concurrency limits are set so a slow dependency can’t stall your app.`}),`\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":"Going to production","description":"Production deployment guide for teams integrating the Noonum REST API and MCP server. Covers auth, key hygiene, error handling, retries, and a pre-launch checklist.","icon":"cloud-arrow-up","href":"/v1/deployment/overview"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Authentication and base URLs","slug":"authentication-and-base-urls","depth":2,"children":[]},{"title":"Key hygiene","slug":"key-hygiene","depth":2,"children":[]},{"title":"Error handling","slug":"error-handling","depth":2,"children":[]},{"title":"Credits and retries","slug":"credits-and-retries","depth":2,"children":[]},{"title":"Pre-launch checklist","slug":"pre-launch-checklist","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"noonum","siteName":"Noonum Developers","title":"Going to production - Noonum Developers","navMaps":{"firstHrefInVersion":{"v2":{"href":"/v2/deployment/overview","matchLevel":1},"v1":{"href":"/v1/deployment/overview","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-10-13T18:30:36.320Z","originalFileLocation":"v1/deployment/overview.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=\"Production deployment guide for teams integrating the Noonum REST API and MCP server. Covers auth, key hygiene, error handling, retries, and a pre-launch checklist.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Noonum Developers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/noonum/xedoG38AYy7ulpW0/_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/noonum/xedoG38AYy7ulpW0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/noonum/xedoG38AYy7ulpW0/_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/noonum/xedoG38AYy7ulpW0/_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/noonum/xedoG38AYy7ulpW0/_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/noonum/xedoG38AYy7ulpW0/_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/noonum/xedoG38AYy7ulpW0/_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/noonum/xedoG38AYy7ulpW0/_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/noonum/xedoG38AYy7ulpW0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Going to production - Noonum Developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Production deployment guide for teams integrating the Noonum REST API and MCP server. Covers auth, key hygiene, error handling, retries, and a pre-launch checklist.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Noonum Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.noonum.ai/v1/deployment/overview\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://noonum.mintlify.site/_mintlify/api/og/v2?division=Resources\u0026amp;title=Going+to+production\u0026amp;description=Production+deployment+guide+for+teams+integrating+the+Noonum+REST+API+and+MCP+server.+Covers+auth%2C+key+hygiene%2C+error+handling%2C+retries%2C+and+a+pre-launch+checkl\u0026amp;theme=1c59985ffbc3b08f1efccbcf\u0026amp;signature=1e8fa5e0e6f47c2a1d2028dd9d5dceadcde628a814a48e749a4cee8d671fd62d\">\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=\"Going to production - Noonum Developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Production deployment guide for teams integrating the Noonum REST API and MCP server. Covers auth, key hygiene, error handling, retries, and a pre-launch checklist.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://noonum.mintlify.site/_mintlify/api/og/v2?division=Resources\u0026amp;title=Going+to+production\u0026amp;description=Production+deployment+guide+for+teams+integrating+the+Noonum+REST+API+and+MCP+server.+Covers+auth%2C+key+hygiene%2C+error+handling%2C+retries%2C+and+a+pre-launch+checkl\u0026amp;theme=1c59985ffbc3b08f1efccbcf\u0026amp;signature=1e8fa5e0e6f47c2a1d2028dd9d5dceadcde628a814a48e749a4cee8d671fd62d\">\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/noonum/xedoG38AYy7ulpW0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Noonum Developers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#283593\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.noonum.ai/v1/deployment/overview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v1/deployment/overview.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.noonum.ai/#organization\",\"name\":\"Noonum Developers\",\"url\":\"https://docs.noonum.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/noonum/hjqoeqYecXinFmHz/logo/light.svg?fit=max\u0026auto=format\u0026n=hjqoeqYecXinFmHz\u0026q=85\u0026s=188c3655522bcd415399dee02c626765\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.noonum.ai#website\",\"name\":\"Noonum Developers\",\"url\":\"https://docs.noonum.ai\",\"publisher\":{\"@id\":\"https://docs.noonum.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.noonum.ai/v1/deployment/overview#webpage\",\"url\":\"https://docs.noonum.ai/v1/deployment/overview\",\"name\":\"Going to production\",\"description\":\"Production deployment guide for teams integrating the Noonum REST API and MCP server. Covers auth, key hygiene, error handling, retries, and a pre-launch checklist.\",\"dateModified\":\"2026-10-13T18:30:36.320Z\",\"isPartOf\":{\"@id\":\"https://docs.noonum.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.noonum.ai/v1/deployment/overview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.noonum.ai/v1/deployment/overview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Noonum Developers\",\"item\":\"https://docs.noonum.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Going to production\",\"item\":\"https://docs.noonum.ai/v1/deployment/overview\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.noonum.ai/v1/deployment/overview#article\",\"headline\":\"Going to production\",\"name\":\"Going to production\",\"description\":\"Production deployment guide for teams integrating the Noonum REST API and MCP server. Covers auth, key hygiene, error handling, retries, and a pre-launch checklist.\",\"url\":\"https://docs.noonum.ai/v1/deployment/overview\",\"mainEntityOfPage\":{\"@id\":\"https://docs.noonum.ai/v1/deployment/overview#webpage\"},\"dateModified\":\"2026-10-13T18:30:36.320Z\",\"publisher\":{\"@id\":\"https://docs.noonum.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.noonum.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Noonum Developers\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Noonum Developers\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/v1/deployment/overview.md","siteName":"Noonum Developers","nav":{"global":null,"versions":[{"version":"v2","default":true,"tag":"Latest","pages":[{"title":"v2","href":"/v2/deployment/overview"}]},{"version":"v1","tabs":[{"tab":"Documentation","icon":"book","groups":[{"group":"Get started","pages":[{"title":"Overview","icon":"home","href":"/v1"},{"title":"Quickstart","icon":"rocket","href":"/v1/getting-started/quickstart"},{"title":"Authentication","icon":"key","href":"/v1/getting-started/authentication"}]},{"group":"Guides","pages":[{"title":"Guides","icon":"book-open","href":"/v1/guides/overview"},{"title":"Build a strategy","icon":"list-check","href":"/v1/guides/build-strategy"},{"title":"Iterate a strategy","icon":"rotate","href":"/v1/guides/iterate-strategy"},{"title":"Analyze and compare strategies","icon":"chart-bar","href":"/v1/guides/analyze-strategies"},{"title":"End-to-end REST integration","icon":"plug","href":"/v1/guides/rest-integration"}]},{"group":"Methodology","pages":[{"title":"Methodology","icon":"flask","href":"/base/concepts/overview"},{"title":"Signals and scores","icon":"scale-balanced","href":"/base/concepts/signals-and-scores"},{"title":"Portfolio optimization","icon":"chart-pie","href":"/base/concepts/portfolio-optimization"},{"title":"Research papers","description":"Published Noonum research behind the linguistic-signal methodology, available as PDFs.","icon":"file-lines","href":"/base/concepts/research-papers"}]},{"group":"Resources","pages":[{"title":"Going to production","icon":"cloud-arrow-up","href":"/v1/deployment/overview"},{"title":"Changelog","description":"Release notes for the Noonum REST API, MCP server, and documentation site.","icon":"clock-rotate-left","href":"/base/changelog"}]}]},{"tab":"Agent Resources","icon":"robot","pages":[{"title":"Agent Resources","href":"/base/agentic/overview"}]},{"tab":"API Reference","icon":"code","pages":[{"title":"API Reference","href":"/v1/api-reference/introduction"}]}]}]},"basePath":"","title":"Going to production - Noonum Developers","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}