Publishable keys run in the browser, secret keys run on your server. How Filecheck keys and scopes work.
Filecheck uses two key types. Get both from the dashboard.
Key
Prefix
Where it runs
Publishable key
pk_live_… / pk_test_…
In page JavaScript. Safe to ship in public code.
Secret key
sk_live_… / sk_test_…
Server-side only. Never put it in browser code.
Never expose a secret key (sk_…) in client-side code, a public repository, or a mobile app bundle. Use it only from your server.
Test and live modes
*_test_… keys run against test data and never bill. *_live_… keys run in production. Swap the key prefix to switch modes; no other code changes are required.
Agent ID (optional)
An agentId (agt_…) scopes the Element to a specific sub-tenant or store. This is useful when one Filecheck account powers multiple storefronts.
const fc = Filecheck('pk_live_…', { agentId: 'agt_…' });
Using the keys
Publishable key initializes the Element in the browser.
Secret key authenticates server-side requests to the API with a bearer token:
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Filecheck","colors":{"primary":"#1F5BFF","light":"#6088FF","dark":"#1747CC"},"logo":{"light":"https://mintcdn.com/filecheck/rNybgOKFlLbMhWeh/logo/light.svg?fit=max\u0026auto=format\u0026n=rNybgOKFlLbMhWeh\u0026q=85\u0026s=7bc29281132ca05b5217412db9e93fb8","dark":"https://mintcdn.com/filecheck/rNybgOKFlLbMhWeh/logo/dark.svg?fit=max\u0026auto=format\u0026n=rNybgOKFlLbMhWeh\u0026q=85\u0026s=e5a15a223efa144fa97287b4b96c0236"},"favicon":"https://mintcdn.com/filecheck/rNybgOKFlLbMhWeh/favicon.svg?fit=max\u0026auto=format\u0026n=rNybgOKFlLbMhWeh\u0026q=85\u0026s=1ca0b6f62da3e8005a37cf842f98f9c3","background":{"color":{"light":"#FFFFFF","dark":"#090B1A"}},"navbar":{"links":[{"href":"https://filecheck.io","label":"Website"}],"primary":{"type":"button","label":"Dashboard","href":"https://admin.filecheck.io"}},"footer":{"socials":{"x":"https://x.com/filecheckio","linkedin":"https://linkedin.com/company/filecheckio"},"links":[{"header":"Trust","items":[{"label":"Security and GDPR","href":"https://filecheck.io/security"},{"label":"Data Processing Agreement","href":"https://filecheck.io/company/dpa"},{"label":"Privacy policy","href":"https://filecheck.io/company/privacy"}]}]},"contextual":{"options":["copy","view","download-spec","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Demos","icon":"play","href":"https://filecheck.io/demos"},{"anchor":"Support","icon":"envelope","href":"mailto:support@filecheck.io"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"filecheck","hasAudioNarration":false,"actualSubdomain":"filecheck","customDomains":["filecheck.io"],"gitSource":{"type":"github","owner":"sterlyai","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"issues":true,"edits":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afb44fbe515a9eaa9c00b6e","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"API reference","count":68},{"language":"default","tag":"Documentation","count":34},{"language":"default","tag":"Developers","count":22},{"language":"default","tag":"Admin guide","count":15},{"language":"default","tag":"Jobs","count":9},{"language":"default","tag":"Preflight Profiles","count":8},{"language":"default","tag":"The Element","count":7},{"language":"default","tag":"Connectors","count":7},{"language":"default","tag":"Optimize presets","count":7},{"language":"default","tag":"Profiles","count":7}]},"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":"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}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/authentication","slug":"/api-reference/authentication","pageMetadata":{"title":"Authentication","description":"Publishable keys run in the browser, secret keys run on your server. How Filecheck keys and scopes work.","href":"/api-reference/authentication"},"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: \"Publishable keys run in the browser, secret keys run on your server. How Filecheck keys and scopes work.\"\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`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Filecheck uses two key types. Get both from the `,_jsx(_components.a,{href:`https://admin.filecheck.io`,children:`dashboard`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Key`}),_jsx(_components.th,{children:`Prefix`}),_jsx(_components.th,{children:`Where it runs`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Publishable key`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`pk_live_…`}),` / `,_jsx(_components.code,{children:`pk_test_…`})]}),_jsx(_components.td,{children:`In page JavaScript. Safe to ship in public code.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Secret key`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`sk_live_…`}),` / `,_jsx(_components.code,{children:`sk_test_…`})]}),_jsx(_components.td,{children:`Server-side only. Never put it in browser code.`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Never expose a secret key (`,_jsx(_components.code,{children:`sk_…`}),`) in client-side code, a public repository, or a mobile app bundle. Use it only from your server.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`test-and-live-modes`,children:`Test and live modes`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`*_test_…`}),` keys run against test data and never bill. `,_jsx(_components.code,{children:`*_live_…`}),` keys run in production. Swap the key prefix to switch modes; no other code changes are required.`]}),`\n`,_jsx(Heading,{level:`2`,id:`agent-id-optional`,children:`Agent ID (optional)`}),`\n`,_jsxs(_components.p,{children:[`An `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`agentId`})}),` (`,_jsx(_components.code,{children:`agt_…`}),`) scopes the Element to a specific sub-tenant or store. This is useful when one Filecheck account powers multiple storefronts.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`javascript`,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:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` fc`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Filecheck`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'pk_live_…'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'agt_…'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`using-the-keys`,children:`Using the keys`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Publishable key`}),` initializes the `,_jsx(_components.a,{href:`/element/installation`,children:`Element`}),` in the browser.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Secret key`}),` authenticates server-side requests to the `,_jsx(_components.a,{href:`/server/verify-jobs`,children:`API`}),` with a bearer token:`]}),`\n`]}),`\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:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.filecheck.io/jobs/{jobId}`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer sk_live_…\"`})]}),`\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","description":"Publishable keys run in the browser, secret keys run on your server. How Filecheck keys and scopes work.","href":"/api-reference/authentication"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Test and live modes","slug":"test-and-live-modes","depth":2,"children":[]},{"title":"Agent ID (optional)","slug":"agent-id-optional","depth":2,"children":[]},{"title":"Using the keys","slug":"using-the-keys","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/filecheck/6de6adfb358c6d44/ga-consent.js"],"subdomain":"filecheck","siteName":"Filecheck","title":"Authentication - Filecheck","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-21T18:57:09.590Z","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=\"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=\"Publishable keys run in the browser, secret keys run on your server. How Filecheck keys and scopes work.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Filecheck\">\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/filecheck/NelkTiDjeD6s_0IH/_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/filecheck/NelkTiDjeD6s_0IH/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/filecheck/NelkTiDjeD6s_0IH/_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/filecheck/NelkTiDjeD6s_0IH/_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/filecheck/NelkTiDjeD6s_0IH/_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/filecheck/NelkTiDjeD6s_0IH/_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/filecheck/NelkTiDjeD6s_0IH/_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/filecheck/NelkTiDjeD6s_0IH/_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/filecheck/NelkTiDjeD6s_0IH/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Authentication - Filecheck\">\u003cmeta data-mint-head property=\"og:description\" content=\"Publishable keys run in the browser, secret keys run on your server. How Filecheck keys and scopes work.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Filecheck\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://filecheck.io/docs/api-reference/authentication\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://filecheck.mintlify.site/docs/_mintlify/api/og/v2?division=Overview\u0026amp;title=Authentication\u0026amp;description=Publishable+keys+run+in+the+browser%2C+secret+keys+run+on+your+server.+How+Filecheck+keys+and+scopes+work.\u0026amp;theme=2d8b0f160f4bd456e90bb9d1\u0026amp;signature=d0a689eab25977aa4eb1f40c14b886015afa3f203b8046fa6d99683ce881023f\">\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=\"Authentication - Filecheck\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Publishable keys run in the browser, secret keys run on your server. How Filecheck keys and scopes work.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://filecheck.mintlify.site/docs/_mintlify/api/og/v2?division=Overview\u0026amp;title=Authentication\u0026amp;description=Publishable+keys+run+in+the+browser%2C+secret+keys+run+on+your+server.+How+Filecheck+keys+and+scopes+work.\u0026amp;theme=2d8b0f160f4bd456e90bb9d1\u0026amp;signature=d0a689eab25977aa4eb1f40c14b886015afa3f203b8046fa6d99683ce881023f\">\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/filecheck/NelkTiDjeD6s_0IH/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Filecheck\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1F5BFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://filecheck.io/docs/api-reference/authentication\">\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/authentication.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://filecheck.io/#organization\",\"name\":\"Filecheck\",\"url\":\"https://filecheck.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/filecheck/rNybgOKFlLbMhWeh/logo/light.svg?fit=max\u0026auto=format\u0026n=rNybgOKFlLbMhWeh\u0026q=85\u0026s=7bc29281132ca05b5217412db9e93fb8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://filecheck.io/docs#website\",\"name\":\"Filecheck\",\"url\":\"https://filecheck.io/docs\",\"publisher\":{\"@id\":\"https://filecheck.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://filecheck.io/docs/api-reference/authentication#webpage\",\"url\":\"https://filecheck.io/docs/api-reference/authentication\",\"name\":\"Authentication\",\"description\":\"Publishable keys run in the browser, secret keys run on your server. How Filecheck keys and scopes work.\",\"dateModified\":\"2026-06-21T18:57:09.590Z\",\"isPartOf\":{\"@id\":\"https://filecheck.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://filecheck.io/docs/api-reference/authentication#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://filecheck.io/docs/api-reference/authentication#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Overview\",\"item\":\"https://filecheck.io/docs/api-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Authentication\",\"item\":\"https://filecheck.io/docs/api-reference/authentication\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://filecheck.io/docs/api-reference/authentication#article\",\"headline\":\"Authentication\",\"name\":\"Authentication\",\"description\":\"Publishable keys run in the browser, secret keys run on your server. How Filecheck keys and scopes work.\",\"url\":\"https://filecheck.io/docs/api-reference/authentication\",\"mainEntityOfPage\":{\"@id\":\"https://filecheck.io/docs/api-reference/authentication#webpage\"},\"dateModified\":\"2026-06-21T18:57:09.590Z\",\"publisher\":{\"@id\":\"https://filecheck.io/#organization\"},\"isPartOf\":{\"@id\":\"https://filecheck.io/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Filecheck\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Filecheck\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/authentication.md","siteName":"Filecheck","nav":{"global":{"anchors":[{"anchor":"Demos","icon":"play","href":"https://filecheck.io/demos"},{"anchor":"Support","icon":"envelope","href":"mailto:support@filecheck.io"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"Developers","pages":[{"title":"Developers","href":"/element/overview"}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API overview","description":"Base URL, authentication, and conventions for the Filecheck REST API.","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"}]},{"group":"Libraries","pages":[{"title":"Official libraries","sidebarTitle":"Overview","description":"Typed packages for JavaScript, React, Vue, Node.js, and PHP, plus an MCP server for AI agents — the fastest way to integrate Filecheck on a custom stack.","href":"/integrations/libraries"}]},{"group":"Jobs","pages":[{"title":"Submit a job","deprecated":null,"version":null,"openapi":"/openapi.json post /jobs","href":"/api-reference/jobs/submit-a-job"},{"title":"List jobs","deprecated":null,"version":null,"openapi":"/openapi.json get /jobs","href":"/api-reference/jobs/list-jobs"},{"title":"Get a job","deprecated":null,"version":null,"openapi":"/openapi.json get /jobs/{id}","href":"/api-reference/jobs/get-a-job"},{"title":"Delete a job","deprecated":null,"version":null,"openapi":"/openapi.json delete /jobs/{id}","href":"/api-reference/jobs/delete-a-job"},{"title":"Preflight a file","deprecated":null,"version":null,"openapi":"/openapi.json post /jobs/preflight","href":"/api-reference/jobs/preflight-a-file"},{"title":"Fix a file","deprecated":null,"version":null,"openapi":"/openapi.json post /jobs/fix","href":"/api-reference/jobs/fix-a-file"},{"title":"Optimize a file","deprecated":null,"version":null,"openapi":"/openapi.json post /jobs/optimize","href":"/api-reference/jobs/optimize-a-file"},{"title":"Validate a file","deprecated":null,"version":null,"openapi":"/openapi.json post /jobs/validate","href":"/api-reference/jobs/validate-a-file"},{"title":"Generate previews","deprecated":null,"version":null,"openapi":"/openapi.json post /jobs/previews","href":"/api-reference/jobs/generate-previews"}]},{"group":"Uploads \u0026 orders","pages":[{"title":"Create an upload","deprecated":null,"version":null,"openapi":"/openapi.json post /uploads","href":"/api-reference/uploads/create-an-upload"},{"title":"Capture an order","deprecated":null,"version":null,"openapi":"/openapi.json post /orders/{id}","href":"/api-reference/orders/capture-an-order"}]},{"group":"Workflows","pages":[{"title":"List workflows","deprecated":null,"version":null,"openapi":"/openapi.json get /workflows","href":"/api-reference/workflows/list-workflows"},{"title":"Get a workflow","deprecated":null,"version":null,"openapi":"/openapi.json get /workflows/{id}","href":"/api-reference/workflows/get-a-workflow"},{"title":"Create a workflow","deprecated":null,"version":null,"openapi":"/openapi.json post /workflows","href":"/api-reference/workflows/create-a-workflow"},{"title":"Update a workflow","deprecated":null,"version":null,"openapi":"/openapi.json patch /workflows/{id}","href":"/api-reference/workflows/update-a-workflow"},{"title":"Delete a workflow","deprecated":null,"version":null,"openapi":"/openapi.json delete /workflows/{id}","href":"/api-reference/workflows/delete-a-workflow"},{"title":"Publish a draft workflow","deprecated":null,"version":null,"openapi":"/openapi.json post /workflows/{id}/publish","href":"/api-reference/workflows/publish-a-draft-workflow"},{"title":"Revert to the catalog workflow","deprecated":null,"version":null,"openapi":"/openapi.json post /workflows/{id}/revert","href":"/api-reference/workflows/revert-to-the-catalog-workflow"}]},{"group":"Rules","pages":[{"title":"List rules","deprecated":null,"version":null,"openapi":"/openapi.json get /rules","href":"/api-reference/rules/list-rules"},{"title":"Get a rule","deprecated":null,"version":null,"openapi":"/openapi.json get /rules/{id}","href":"/api-reference/rules/get-a-rule"},{"title":"Create a rule","deprecated":null,"version":null,"openapi":"/openapi.json post /rules","href":"/api-reference/rules/create-a-rule"},{"title":"Update a rule","deprecated":null,"version":null,"openapi":"/openapi.json patch /rules/{id}","href":"/api-reference/rules/update-a-rule"},{"title":"Delete a rule","deprecated":null,"version":null,"openapi":"/openapi.json delete /rules/{id}","href":"/api-reference/rules/delete-a-rule"},{"title":"Publish a draft rule","deprecated":null,"version":null,"openapi":"/openapi.json post /rules/{id}/publish","href":"/api-reference/rules/publish-a-draft-rule"},{"title":"Revert to the catalog rule","deprecated":null,"version":null,"openapi":"/openapi.json post /rules/{id}/revert","href":"/api-reference/rules/revert-to-the-catalog-rule"}]},{"group":"Profiles","pages":[{"title":"List preflight profiles","deprecated":null,"version":null,"openapi":"/openapi.json get /profiles","href":"/api-reference/profiles/list-preflight-profiles"},{"title":"Get a preflight profile","deprecated":null,"version":null,"openapi":"/openapi.json get /profiles/{id}","href":"/api-reference/profiles/get-a-preflight-profile"},{"title":"Create a preflight profile","deprecated":null,"version":null,"openapi":"/openapi.json post /profiles","href":"/api-reference/profiles/create-a-preflight-profile"},{"title":"Update a preflight profile","deprecated":null,"version":null,"openapi":"/openapi.json patch /profiles/{id}","href":"/api-reference/profiles/update-a-preflight-profile"},{"title":"Delete a preflight profile","deprecated":null,"version":null,"openapi":"/openapi.json delete /profiles/{id}","href":"/api-reference/profiles/delete-a-preflight-profile"},{"title":"Publish a draft preflight profile","deprecated":null,"version":null,"openapi":"/openapi.json post /profiles/{id}/publish","href":"/api-reference/profiles/publish-a-draft-preflight-profile"},{"title":"Revert to the catalog preflight profile","deprecated":null,"version":null,"openapi":"/openapi.json post /profiles/{id}/revert","href":"/api-reference/profiles/revert-to-the-catalog-preflight-profile"}]},{"group":"Connectors","pages":[{"title":"List connectors","deprecated":null,"version":null,"openapi":"/openapi.json get /connectors","href":"/api-reference/connectors/list-connectors"},{"title":"Get a connector","deprecated":null,"version":null,"openapi":"/openapi.json get /connectors/{id}","href":"/api-reference/connectors/get-a-connector"},{"title":"Create a connector","deprecated":null,"version":null,"openapi":"/openapi.json post /connectors","href":"/api-reference/connectors/create-a-connector"},{"title":"Update a connector","deprecated":null,"version":null,"openapi":"/openapi.json patch /connectors/{id}","href":"/api-reference/connectors/update-a-connector"},{"title":"Delete a connector","deprecated":null,"version":null,"openapi":"/openapi.json delete /connectors/{id}","href":"/api-reference/connectors/delete-a-connector"},{"title":"Publish a draft connector","deprecated":null,"version":null,"openapi":"/openapi.json post /connectors/{id}/publish","href":"/api-reference/connectors/publish-a-draft-connector"},{"title":"Revert to the catalog connector","deprecated":null,"version":null,"openapi":"/openapi.json post /connectors/{id}/revert","href":"/api-reference/connectors/revert-to-the-catalog-connector"}]},{"group":"Optimize presets","pages":[{"title":"List optimize presets","deprecated":null,"version":null,"openapi":"/openapi.json get /optimize-presets","href":"/api-reference/optimize-presets/list-optimize-presets"},{"title":"Get a optimize preset","deprecated":null,"version":null,"openapi":"/openapi.json get /optimize-presets/{id}","href":"/api-reference/optimize-presets/get-a-optimize-preset"},{"title":"Create a optimize preset","deprecated":null,"version":null,"openapi":"/openapi.json post /optimize-presets","href":"/api-reference/optimize-presets/create-a-optimize-preset"},{"title":"Update a optimize preset","deprecated":null,"version":null,"openapi":"/openapi.json patch /optimize-presets/{id}","href":"/api-reference/optimize-presets/update-a-optimize-preset"},{"title":"Delete a optimize preset","deprecated":null,"version":null,"openapi":"/openapi.json delete /optimize-presets/{id}","href":"/api-reference/optimize-presets/delete-a-optimize-preset"},{"title":"Publish a draft optimize preset","deprecated":null,"version":null,"openapi":"/openapi.json post /optimize-presets/{id}/publish","href":"/api-reference/optimize-presets/publish-a-draft-optimize-preset"},{"title":"Revert to the catalog optimize preset","deprecated":null,"version":null,"openapi":"/openapi.json post /optimize-presets/{id}/revert","href":"/api-reference/optimize-presets/revert-to-the-catalog-optimize-preset"}]},{"group":"Destinations","pages":[{"title":"List destinations","deprecated":null,"version":null,"openapi":"/openapi.json get /destinations","href":"/api-reference/destinations/list-destinations"},{"title":"Get a destination","deprecated":null,"version":null,"openapi":"/openapi.json get /destinations/{id}","href":"/api-reference/destinations/get-a-destination"},{"title":"Create a destination","deprecated":null,"version":null,"openapi":"/openapi.json post /destinations","href":"/api-reference/destinations/create-a-destination"},{"title":"Update a destination","deprecated":null,"version":null,"openapi":"/openapi.json patch /destinations/{id}","href":"/api-reference/destinations/update-a-destination"},{"title":"Delete a destination","deprecated":null,"version":null,"openapi":"/openapi.json delete /destinations/{id}","href":"/api-reference/destinations/delete-a-destination"},{"title":"Test a destination","deprecated":null,"version":null,"openapi":"/openapi.json post /destinations/{id}/test","href":"/api-reference/destinations/test-a-destination"}]},{"group":"Products","pages":[{"title":"List product mappings","deprecated":null,"version":null,"openapi":"/openapi.json get /product-maps","href":"/api-reference/products/list-product-mappings"},{"title":"Map a product to a workflow","deprecated":null,"version":null,"openapi":"/openapi.json put /product-maps/{id}","href":"/api-reference/products/map-a-product-to-a-workflow"},{"title":"Unmap a product","deprecated":null,"version":null,"openapi":"/openapi.json delete /product-maps/{id}","href":"/api-reference/products/unmap-a-product"},{"title":"Find products in your store","deprecated":null,"version":null,"openapi":"/openapi.json get /products","href":"/api-reference/products/find-products-in-your-store"}]},{"group":"Settings","pages":[{"title":"Get the storefront settings","deprecated":null,"version":null,"openapi":"/openapi.json get /settings","href":"/api-reference/settings/get-the-storefront-settings"},{"title":"Update the storefront settings","deprecated":null,"version":null,"openapi":"/openapi.json patch /settings","href":"/api-reference/settings/update-the-storefront-settings"}]},{"group":"Webhooks","pages":[{"title":"List webhook events","deprecated":null,"version":null,"openapi":"/openapi.json get /webhook-events","href":"/api-reference/webhooks/list-webhook-events"},{"title":"List webhooks","deprecated":null,"version":null,"openapi":"/openapi.json get /webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Get a webhook","deprecated":null,"version":null,"openapi":"/openapi.json get /webhooks/{id}","href":"/api-reference/webhooks/get-a-webhook"},{"title":"Create a webhook","deprecated":null,"version":null,"openapi":"/openapi.json post /webhooks","href":"/api-reference/webhooks/create-a-webhook"},{"title":"Update a webhook","deprecated":null,"version":null,"openapi":"/openapi.json patch /webhooks/{id}","href":"/api-reference/webhooks/update-a-webhook"},{"title":"Delete a webhook","deprecated":null,"version":null,"openapi":"/openapi.json delete /webhooks/{id}","href":"/api-reference/webhooks/delete-a-webhook"},{"title":"Send a test event","deprecated":null,"version":null,"openapi":"/openapi.json post /webhooks/{id}/test","href":"/api-reference/webhooks/send-a-test-event"}]}]}]},"basePath":"","title":"Authentication - Filecheck","deploymentId":"dpl_81ettUQ5G7NASN425B6JKU3FX1Rg","buildId":"dpl_81ettUQ5G7NASN425B6JKU3FX1Rg","dynamics":[],"chunks":[]}