Introduction to the SkillsDB public GraphQL API and how to begin integrating
Quick Summary: SkillsDB exposes a public GraphQL API that your internal systems can use to integrate with and automate processes. Contact SkillsDB to whitelist your domain before beginning.
SkillsDB exposes a public GraphQL API. This API can be used by your internal systems to communicate with SkillsDB and automate processes seamlessly.We use this same API internally for developing our application.The next section describes the authentication modes we support and how to communicate with the API.
Please contact us before beginning, as your API endpoint URL is required to be whitelisted. SkillsDB limits connections to allowed domain URLs only.
API interactions are limited a single authenticated SkillsDB account only.
Need Help?
If you run into any issues or have questions, reach out to your organization’s SkillsDB administrator or contact SkillsDB Support.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SkillsDB","description":"Mission Control for Your Team","colors":{"primary":"#3381FF","light":"#3381FF","dark":"#67A1FF"},"logo":{"light":"https://mintcdn.com/skillsdb/yRKAbieJig14MgS8/images/SkillsDBLogoLightLockup.svg?fit=max\u0026auto=format\u0026n=yRKAbieJig14MgS8\u0026q=85\u0026s=17ff76947d50e242f7b378d68ba08cf1","dark":"https://mintcdn.com/skillsdb/yRKAbieJig14MgS8/images/SkillsDBLogoDarkLockup.svg?fit=max\u0026auto=format\u0026n=yRKAbieJig14MgS8\u0026q=85\u0026s=c577c0af0cae5c4230fe36c8a81c326b"},"appearance":{"default":"system"},"seo":{"indexing":"all"},"fonts":{"family":"Inter"},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode","mcp","add-mcp"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"skillsdb","hasAudioNarration":false,"actualSubdomain":"skillsdb","customDomains":["help.skillsdb.com"],"gitSource":{"type":"github","owner":"skillsdb","repo":"skillsdb-next","deployBranch":"main","contentDirectory":"help-docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b01ca19d00c6c0f47fe32b9","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":356},{"language":"default","tag":"System Objects","count":216},{"language":"default","tag":"Team Data","count":112},{"language":"default","tag":"Documentation","count":86},{"language":"default","tag":"Labels \u0026 Flags","count":60},{"language":"default","tag":"Careers","count":45},{"language":"default","tag":"People \u0026 Organization","count":44},{"language":"default","tag":"Training Library","count":31},{"language":"default","tag":"Core Concepts","count":30},{"language":"default","tag":"Survey Results","count":25}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@skillsdb.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-docs/getting-started","slug":"/api-docs/getting-started","pageMetadata":{"title":"Getting Started","description":"Introduction to the SkillsDB public GraphQL API and how to begin integrating","href":"/api-docs/getting-started"},"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: \"Introduction to the SkillsDB public GraphQL API and how to begin integrating\"\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`,hr:`hr`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,Info,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Quick Summary:`}),` SkillsDB exposes a public GraphQL API that your internal systems can use to integrate with and automate processes. Contact SkillsDB to whitelist your domain before beginning.`]})}),`\n`,_jsx(_components.p,{children:`SkillsDB exposes a public GraphQL API. This API can be used by your internal systems to communicate with SkillsDB and automate processes seamlessly.`}),`\n`,_jsx(_components.p,{children:`We use this same API internally for developing our application.`}),`\n`,_jsx(_components.p,{children:`The next section describes the authentication modes we support and how to communicate with the API.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Please contact us before beginning, as your API endpoint URL is required to be whitelisted. SkillsDB limits connections to allowed domain URLs only.`})}),`\n`,_jsx(_components.p,{children:`API interactions are limited a single authenticated SkillsDB account only.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`1`,id:`need-help`,children:`Need Help?`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`If you run into any issues or have questions, reach out to your organization’s SkillsDB administrator or contact `,_jsx(_components.a,{href:`https://www.skillsdb.com/support`,children:`SkillsDB Support`}),`.`]})})]})}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":"Getting Started","description":"Introduction to the SkillsDB public GraphQL API and how to begin integrating","href":"/api-docs/getting-started"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Need Help?","slug":"need-help","depth":1,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"skillsdb","siteName":"SkillsDB","title":"Getting Started - SkillsDB","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-10T19:00:00.049Z","originalFileLocation":"api-docs/getting-started.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=\"Introduction to the SkillsDB public GraphQL API and how to begin integrating\">\u003cmeta data-mint-head name=\"application-name\" content=\"SkillsDB\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/skillsdb/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/skillsdb/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/skillsdb/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/skillsdb/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Getting Started - SkillsDB\">\u003cmeta data-mint-head property=\"og:description\" content=\"Introduction to the SkillsDB public GraphQL API and how to begin integrating\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SkillsDB\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://help.skillsdb.com/api-docs/getting-started\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://skillsdb.mintlify.site/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Getting+Started\u0026amp;description=Introduction+to+the+SkillsDB+public+GraphQL+API+and+how+to+begin+integrating\u0026amp;theme=8b7b84b60ff31598f303a903\u0026amp;signature=cdcd7ff439dfa00d787aeaa80eff9b97f0a01a9c8bb4514375c0333efec409c0\">\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=\"Getting Started - SkillsDB\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Introduction to the SkillsDB public GraphQL API and how to begin integrating\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://skillsdb.mintlify.site/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Getting+Started\u0026amp;description=Introduction+to+the+SkillsDB+public+GraphQL+API+and+how+to+begin+integrating\u0026amp;theme=8b7b84b60ff31598f303a903\u0026amp;signature=cdcd7ff439dfa00d787aeaa80eff9b97f0a01a9c8bb4514375c0333efec409c0\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/skillsdb/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SkillsDB\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3381FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://help.skillsdb.com/api-docs/getting-started\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-docs/getting-started.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://help.skillsdb.com/#organization\",\"name\":\"SkillsDB\",\"url\":\"https://help.skillsdb.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/skillsdb/yRKAbieJig14MgS8/images/SkillsDBLogoLightLockup.svg?fit=max\u0026auto=format\u0026n=yRKAbieJig14MgS8\u0026q=85\u0026s=17ff76947d50e242f7b378d68ba08cf1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://help.skillsdb.com#website\",\"name\":\"SkillsDB\",\"url\":\"https://help.skillsdb.com\",\"publisher\":{\"@id\":\"https://help.skillsdb.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://help.skillsdb.com/api-docs/getting-started#webpage\",\"url\":\"https://help.skillsdb.com/api-docs/getting-started\",\"name\":\"Getting Started\",\"description\":\"Introduction to the SkillsDB public GraphQL API and how to begin integrating\",\"dateModified\":\"2026-04-10T19:00:00.049Z\",\"isPartOf\":{\"@id\":\"https://help.skillsdb.com#website\"},\"breadcrumb\":{\"@id\":\"https://help.skillsdb.com/api-docs/getting-started#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.skillsdb.com/api-docs/getting-started#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SkillsDB\",\"item\":\"https://help.skillsdb.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Getting Started\",\"item\":\"https://help.skillsdb.com/api-docs/getting-started\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://help.skillsdb.com/api-docs/getting-started#article\",\"headline\":\"Getting Started\",\"name\":\"Getting Started\",\"description\":\"Introduction to the SkillsDB public GraphQL API and how to begin integrating\",\"url\":\"https://help.skillsdb.com/api-docs/getting-started\",\"mainEntityOfPage\":{\"@id\":\"https://help.skillsdb.com/api-docs/getting-started#webpage\"},\"dateModified\":\"2026-04-10T19:00:00.049Z\",\"publisher\":{\"@id\":\"https://help.skillsdb.com/#organization\"},\"isPartOf\":{\"@id\":\"https://help.skillsdb.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SkillsDB\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"SkillsDB\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-docs/getting-started.md","siteName":"SkillsDB","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","icon":"code","pages":[{"title":"API Reference","href":"/api-docs/rest/getting-started"}]},{"tab":"GraphQL API","icon":"arrows-spin","groups":[{"group":"Getting Started","icon":"play","expanded":true,"pages":[{"title":"Getting Started","href":"/api-docs/getting-started"},{"title":"Our Commitment to GraphQL Integrators","description":"The GraphQL API is not being deprecated — what the new REST API means for existing integrations","href":"/api-docs/graphql-commitment"},{"title":"Authentication","href":"/api-docs/authentication"},{"title":"GraphQL Schema","href":"/api-docs/graphql-schema"}]},{"group":"Conventions","icon":"list-check","pages":[{"title":"Pagination","href":"/api-docs/pagination"},{"title":"Filtering","href":"/api-docs/filtering"},{"title":"Sorting","href":"/api-docs/sorting"}]},{"group":"Guides","icon":"compass","pages":[{"title":"People Provisioning","href":"/api-docs/people-provisioning"},{"title":"Learning Resource Assignment","href":"/api-docs/learning-resource-assignment"},{"title":"Migrating from Legacy API","href":"/api-docs/migrating-from-legacy-api"}]}]}]},"basePath":"","title":"Getting Started - SkillsDB","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}