This endpoint creates multiple external knowledge records in one call. Each record accepts the same fields as Create a new external knowledge. Records are always created, not updated.
The batch is saved as a whole: if any record fails, nothing is saved and the error for that record is returned.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tribal Habits API","description":"Reference for the Tribal Habits Public API V1.","colors":{"primary":"#7C299B","light":"#FF754A","dark":"#7C299B"},"logo":{"light":"https://mintcdn.com/tribal-habits/dbtAL_otpFb7lO5f/logo/light.png?fit=max\u0026auto=format\u0026n=dbtAL_otpFb7lO5f\u0026q=85\u0026s=27cd12465618e8e083443fe905630191","dark":"https://mintcdn.com/tribal-habits/dbtAL_otpFb7lO5f/logo/dark.png?fit=max\u0026auto=format\u0026n=dbtAL_otpFb7lO5f\u0026q=85\u0026s=a9313585e676ec6e1d0350c81464edee"},"favicon":"https://mintcdn.com/tribal-habits/dbtAL_otpFb7lO5f/favicon.png?fit=max\u0026auto=format\u0026n=dbtAL_otpFb7lO5f\u0026q=85\u0026s=cf0b5e6c683ece3eff3e26eb5fe8a773","api":{"playground":{"display":"simple"},"examples":{"languages":["curl","python","javascript","php","csharp","ruby"]},"url":"full"},"fonts":{"family":"Barlow"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tribal-habits","hasAudioNarration":false,"actualSubdomain":"tribal-habits","customDomains":["api-docs.tribalhabits.com"],"gitSource":{"type":"github","owner":"tribalhabits","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ac718329937db71086c8a9e","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Enrolments","count":7},{"language":"default","tag":"Users","count":6},{"language":"default","tag":"Getting started","count":5},{"language":"default","tag":"Webhooks","count":5},{"language":"default","tag":"External Knowledge","count":5},{"language":"default","tag":"Certificates","count":4},{"language":"default","tag":"Enrolment events","count":4},{"language":"default","tag":"Pathways","count":2},{"language":"default","tag":"Topics","count":2}]},"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":"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":"llms-txt-v2","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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/external-knowledge/batch-create-external-knowledge","slug":"/api-reference/external-knowledge/batch-create-external-knowledge","pageMetadata":{"title":"Batch create external knowledge","description":"This endpoint creates multiple external knowledge records in one call. Each record accepts the same fields as [Create a new external knowledge](/api-reference/external-knowledge/create-a-new-external-knowledge). Records are always created, not updated.\n\nThe batch is saved as a whole: if any record fails, nothing is saved and the error for that record is returned.\n\n\u003cNote>Maximum permitted batch size is 100.\u003c/Note>\n","deprecated":null,"version":null,"sidebarTitle":"Batch create external knowledge","openapi":"/openapi.yaml post /external_knowledges/batch_save","href":"/api-reference/external-knowledge/batch-create-external-knowledge","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n }, {Note} = _components;\n if (!Note) _missingMdxReference(\"Note\", true);\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"This endpoint creates multiple external knowledge records in one call. Each record accepts the same fields as \", _jsx(_components.a, {\n href: \"/api-reference/external-knowledge/create-a-new-external-knowledge\",\n children: \"Create a new external knowledge\"\n }), \". Records are always created, not updated.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"The batch is saved as a whole: if any record fails, nothing is saved and the error for that record is returned.\"\n }), \"\\n\", _jsx(Note, {\n children: \"Maximum permitted batch size is 100.\"\n })]\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};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Batch create external knowledge","description":"This endpoint creates multiple external knowledge records in one call. Each record accepts the same fields as [Create a new external knowledge](/api-reference/external-knowledge/create-a-new-external-knowledge). Records are always created, not updated.\n\nThe batch is saved as a whole: if any record fails, nothing is saved and the error for that record is returned.\n\n\u003cNote>Maximum permitted batch size is 100.\u003c/Note>\n","deprecated":null,"version":null,"sidebarTitle":"Batch create external knowledge","openapi":"/openapi.yaml post /external_knowledges/batch_save","href":"/api-reference/external-knowledge/batch-create-external-knowledge","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["External Knowledge"],"summary":"Batch create external knowledge","operationId":"batchSaveExternalKnowledges","x-mint":{"href":"/api-reference/external-knowledge/batch-create-external-knowledge"},"description":"This endpoint creates multiple external knowledge records in one call. Each record accepts the same fields as [Create a new external knowledge](/api-reference/external-knowledge/create-a-new-external-knowledge). Records are always created, not updated.\n\nThe batch is saved as a whole: if any record fails, nothing is saved and the error for that record is returned.\n\n\u003cNote>Maximum permitted batch size is 100.\u003c/Note>\n","requestBody":"0489cf0b-bba3-4b0c-ba0c-c0500e5a83af","responses":{"200":"c2aa1c4a-d118-4192-bafd-903d716511c4","401":"932af190-a5cf-4e7a-9213-541a581d0025","406":"fec8f691-e426-40b8-b46d-e40574403f3b","429":"24ca4204-f568-46f2-9f5a-c8e3b35fc279"},"method":"post","type":"path","servers":["5b181cef-4c1b-4ab4-aabd-5d711881fabe"],"security":["62386c5b-2ccf-48a5-9016-ec4034f256e6"],"path":"/external_knowledges/batch_save","baseUrlOptions":["https://myorg.tribalhabits.com/papi"],"title":"Batch create external knowledge","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","php","csharp","ruby"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","urlDisplay":"full"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["external_knowledges"],"properties":{"external_knowledges":{"type":"array","maxItems":100,"description":"An array of external knowledge objects","items":{"type":"object","required":["user_name","title","provider","date_obtained"],"properties":{"user_name":{"type":"string","description":"User name of the person this knowledge belongs to (case-insensitive)","isRequired":true,"uniqueKey":"external_knowledges.items.[INDEX].user_name","typeLabel":"string"},"title":{"type":"string","description":"Title of external knowledge. Set automatically to `Development Plan` for Development Plans","isRequired":true,"uniqueKey":"external_knowledges.items.[INDEX].title","typeLabel":"string"},"provider":{"type":"string","description":"Provider","isRequired":true,"uniqueKey":"external_knowledges.items.[INDEX].provider","typeLabel":"string"},"date_obtained":{"type":"string","description":"The date you obtained this knowledge. Formats: 'yyyy-mm-dd', 'dd/mm/yyyy' or 'dd/mm/yy'. `date` is accepted as an alternative name","isRequired":true,"uniqueKey":"external_knowledges.items.[INDEX].date_obtained","typeLabel":"string"},"knowledge_type":{"description":"Required, unless `type` is given. `1` = Training, `2` = Certificate, `3` = Qualification, `4` = License, `5` = Document, `6` = Development Plan. Can also be sent as a string, eg `\"1\"`. Or use `type`","type":"integer","enum":[1,2,3,4,5,6],"uniqueKey":"external_knowledges.items.[INDEX].knowledge_type","typeLabel":"enum\u003cinteger>"},"type":{"type":"string","description":"Alternative to `knowledge_type`, as text: `Training`, `Certificate`, `Qualification`, `License`, `Document` or `Development Plan` (case-insensitive). Required to use `document_type` or the Development Plan fields","uniqueKey":"external_knowledges.items.[INDEX].type","typeLabel":"string"},"document_type":{"type":"string","description":"For `type` `Document` only. The type of Document, eg General, Employment, Financial, Medical, Performance, Policy, Travel, Registration, Membership. Stored in `code`","uniqueKey":"external_knowledges.items.[INDEX].document_type","typeLabel":"string"},"code":{"type":"string","description":"Optional code for the external knowledge","uniqueKey":"external_knowledges.items.[INDEX].code","typeLabel":"string"},"certificate_number":{"type":"string","description":"Certificate Number","uniqueKey":"external_knowledges.items.[INDEX].certificate_number","typeLabel":"string"},"country_obtained":{"type":"string","description":"Country in code form (eg 'AU' for Australia)","uniqueKey":"external_knowledges.items.[INDEX].country_obtained","typeLabel":"string"},"state_obtained":{"type":"string","description":"State or Region in code form (eg 'NSW'). `region_obtained` is accepted as an alternative name","uniqueKey":"external_knowledges.items.[INDEX].state_obtained","typeLabel":"string"},"expires":{"type":"string","description":"Date the knowledge expires. Same formats as `date_obtained`","uniqueKey":"external_knowledges.items.[INDEX].expires","typeLabel":"string"},"qualification_level":{"type":"string","description":"Qualification level, eg `Certificate IV`, `Diploma`, `Bachelor Degree`","uniqueKey":"external_knowledges.items.[INDEX].qualification_level","typeLabel":"string"},"assessment_score":{"type":"number","description":"Assessment score as a decimal, eg 1.2","uniqueKey":"external_knowledges.items.[INDEX].assessment_score","typeLabel":"number"},"total_time":{"type":"integer","description":"Time in minutes, as a whole number","uniqueKey":"external_knowledges.items.[INDEX].total_time","typeLabel":"integer"},"notes":{"type":"string","description":"Notes","uniqueKey":"external_knowledges.items.[INDEX].notes","typeLabel":"string"},"klass":{"type":"string","description":"Class of knowledge. `class` is accepted as an alternative name","uniqueKey":"external_knowledges.items.[INDEX].klass","typeLabel":"string"},"reviewer":{"type":"string","description":"For `type` `Development Plan` only. Stored in `provider`","uniqueKey":"external_knowledges.items.[INDEX].reviewer","typeLabel":"string"},"date_signed":{"type":"string","description":"For `type` `Development Plan` only. Stored in `date_obtained`","uniqueKey":"external_knowledges.items.[INDEX].date_signed","typeLabel":"string"},"next_review_date":{"type":"string","description":"For `type` `Development Plan` only. Stored in `expires`","uniqueKey":"external_knowledges.items.[INDEX].next_review_date","typeLabel":"string"},"stage":{"type":"string","enum":["Initial","Mid Review","End Review"],"description":"For `type` `Development Plan` only. `Initial`, `Mid Review` or `End Review`. Stored in `code`","uniqueKey":"external_knowledges.items.[INDEX].stage","typeLabel":"enum\u003cstring>"},"development_focus":{"type":"string","enum":["At Level","Transition","Progression"],"description":"For Development Plans: `At Level`, `Transition` or `Progression`","uniqueKey":"external_knowledges.items.[INDEX].development_focus","typeLabel":"enum\u003cstring>"},"skills_attained":{"type":"string","description":"Skill names attained by this knowledge. Separate multiple skills with ;. Unknown skills are ignored","uniqueKey":"external_knowledges.items.[INDEX].skills_attained","typeLabel":"string"},"category_1":{"type":"string","description":"Category name attained in the knowledge. Unknown categories return `400`","uniqueKey":"external_knowledges.items.[INDEX].category_1","typeLabel":"string"},"category_1_points":{"type":"number","description":"Points for category 1, eg `10` or `12.5`. Stored to 2 decimal places. Can also be sent as a numeric string, eg `\"10\"`","uniqueKey":"external_knowledges.items.[INDEX].category_1_points","typeLabel":"number"},"category_1_time":{"type":"number","description":"Time in minutes for category 1, eg `60` or `90.5`. Can also be sent as a numeric string, eg `\"60\"`","uniqueKey":"external_knowledges.items.[INDEX].category_1_time","typeLabel":"number"},"category_2":{"type":"string","description":"Category name attained in the knowledge. Unknown categories return `400`","uniqueKey":"external_knowledges.items.[INDEX].category_2","typeLabel":"string"},"category_2_points":{"type":"number","description":"Points for category 2, eg `10` or `12.5`. Stored to 2 decimal places. Can also be sent as a numeric string, eg `\"10\"`","uniqueKey":"external_knowledges.items.[INDEX].category_2_points","typeLabel":"number"},"category_2_time":{"type":"number","description":"Time in minutes for category 2, eg `60` or `90.5`. Can also be sent as a numeric string, eg `\"60\"`","uniqueKey":"external_knowledges.items.[INDEX].category_2_time","typeLabel":"number"},"category_3":{"type":"string","description":"Category name attained in the knowledge. Unknown categories return `400`","uniqueKey":"external_knowledges.items.[INDEX].category_3","typeLabel":"string"},"category_3_points":{"type":"number","description":"Points for category 3, eg `10` or `12.5`. Stored to 2 decimal places. Can also be sent as a numeric string, eg `\"10\"`","uniqueKey":"external_knowledges.items.[INDEX].category_3_points","typeLabel":"number"},"category_3_time":{"type":"number","description":"Time in minutes for category 3, eg `60` or `90.5`. Can also be sent as a numeric string, eg `\"60\"`","uniqueKey":"external_knowledges.items.[INDEX].category_3_time","typeLabel":"number"}},"uniqueKey":"external_knowledges.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"external_knowledges","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"external_knowledges":[{"user_name":"johnny","title":"First Aid Certificate","provider":"Red Cross","type":"Certificate","date_obtained":"1/6/2021","expires":"1/6/2024"},{"user_name":"mary","title":"Forklift Licence","provider":"WorkSafe","type":"License","date_obtained":"2023-03-15"}]},"examples":{"Example":{"title":"Example","value":{"external_knowledges":[{"user_name":"johnny","title":"First Aid Certificate","provider":"Red Cross","type":"Certificate","date_obtained":"1/6/2021","expires":"1/6/2024"},{"user_name":"mary","title":"Forklift Licence","provider":"WorkSafe","type":"License","date_obtained":"2023-03-15"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"c2aa1c4a-d118-4192-bafd-903d716511c4":{"description":"Batch results","content":{"application/json":{"schema":{"type":"object","properties":{"created":{"type":"integer","description":"Number of records created","uniqueKey":"created","typeLabel":"integer"},"updated":{"type":"integer","description":"Number of records updated","uniqueKey":"updated","typeLabel":"integer"},"unchanged":{"type":"integer","description":"Number of records unchanged","uniqueKey":"unchanged","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"created":2,"updated":0,"unchanged":0},"examples":{"Example":{"title":"Example","value":{"created":2,"updated":0,"unchanged":0}}},"exampleType":"examples"}},"exampleType":"examples"},"932af190-a5cf-4e7a-9213-541a581d0025":{"description":"Unauthorized - The request does not include the API key, the API key is incorrect, or API access is not enabled on your plan.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"fec8f691-e426-40b8-b46d-e40574403f3b":{"description":"Not Acceptable - A `POST` or `PUT` request had a `Content-Type` header other than `application/json`","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"24ca4204-f568-46f2-9f5a-c8e3b35fc279":{"description":"Too Many Requests - You have exceeded the rate limit. See [Rate limits](/rate-limits)","headers":{"Retry-After":{"description":"Number of seconds until the rate limit window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"retry_after_seconds":{"type":"integer","uniqueKey":"retry_after_seconds","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Rate limit exceeded. Please slow down.","retry_after_seconds":23},"examples":{"Example":{"title":"Example","value":{"error":"Rate limit exceeded. Please slow down.","retry_after_seconds":23}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"62386c5b-2ccf-48a5-9016-ec4034f256e6":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"Authorization","description":"Your organisation's API key, sent as `Authorization: my_api_key`. The key can also be passed as an `api_key` query parameter. See [Authentication](/authentication).\n","scopes":[],"schemeName":"ApiKeyHeader"}}},"servers":{"5b181cef-4c1b-4ab4-aabd-5d711881fabe":{"url":"https://myorg.tribalhabits.com/papi"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Your organisation's API key, sent as `Authorization: my_api_key`. The key can also be passed as an `api_key` query parameter. See [Authentication](/authentication).\n","scopes":[],"schemeName":"ApiKeyHeader"},"schema":{"title":"Authorization","type":"string","description":"Your organisation's API key, sent as `Authorization: my_api_key`. The key can also be passed as an `api_key` query parameter. See [Authentication](/authentication).\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyHeader","name":"Authorization"}],"title":"ApiKeyHeader"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"tribal-habits","siteName":"Tribal Habits API","title":"Batch create external knowledge - Tribal Habits API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-08T04:12:39.993Z","originalFileLocation":"api-reference/external-knowledge/batch-create-external-knowledge.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=\"This endpoint creates multiple external knowledge records in one call. Each record accepts the same fields as Create a new external knowledge. Records are always created, not updated. The batch is saved as a whole: if any record fails, nothing is saved and the error for that record is returned. Maximum permitted batch size is 100.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tribal Habits API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tribal-habits/bUA3GI8z0PbH28Cb/_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/tribal-habits/bUA3GI8z0PbH28Cb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tribal-habits/bUA3GI8z0PbH28Cb/_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/tribal-habits/bUA3GI8z0PbH28Cb/_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/tribal-habits/bUA3GI8z0PbH28Cb/_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/tribal-habits/bUA3GI8z0PbH28Cb/_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/tribal-habits/bUA3GI8z0PbH28Cb/_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/tribal-habits/bUA3GI8z0PbH28Cb/_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/tribal-habits/bUA3GI8z0PbH28Cb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Batch create external knowledge - Tribal Habits API\">\u003cmeta data-mint-head property=\"og:description\" content=\"This endpoint creates multiple external knowledge records in one call. Each record accepts the same fields as Create a new external knowledge. Records are always created, not updated. The batch is saved as a whole: if any record fails, nothing is saved and the error for that record is returned. Maximum permitted batch size is 100.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tribal Habits API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://api-docs.tribalhabits.com/api-reference/external-knowledge/batch-create-external-knowledge\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tribal-habits.mintlify.site/_mintlify/api/og/v2?division=External+Knowledge\u0026amp;title=Batch+create+external+knowledge\u0026amp;description=This+endpoint+creates+multiple+external+knowledge+records+in+one+call.+Each+record+accepts+the+same+fields+as+%5BCreate+a+new+external+knowledge%5D%28%2Fapi-reference%2Fe\u0026amp;theme=dae6b6579c606a6e034e45ee\u0026amp;signature=ed46959104392197988caf0c0f897a1e6da1fe039fa134da11c36b12f7186b3e\">\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=\"Batch create external knowledge - Tribal Habits API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This endpoint creates multiple external knowledge records in one call. Each record accepts the same fields as Create a new external knowledge. Records are always created, not updated. The batch is saved as a whole: if any record fails, nothing is saved and the error for that record is returned. Maximum permitted batch size is 100.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tribal-habits.mintlify.site/_mintlify/api/og/v2?division=External+Knowledge\u0026amp;title=Batch+create+external+knowledge\u0026amp;description=This+endpoint+creates+multiple+external+knowledge+records+in+one+call.+Each+record+accepts+the+same+fields+as+%5BCreate+a+new+external+knowledge%5D%28%2Fapi-reference%2Fe\u0026amp;theme=dae6b6579c606a6e034e45ee\u0026amp;signature=ed46959104392197988caf0c0f897a1e6da1fe039fa134da11c36b12f7186b3e\">\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/tribal-habits/bUA3GI8z0PbH28Cb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tribal Habits API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7C299B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://api-docs.tribalhabits.com/api-reference/external-knowledge/batch-create-external-knowledge\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/external-knowledge/batch-create-external-knowledge.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://api-docs.tribalhabits.com/#organization\",\"name\":\"Tribal Habits API\",\"url\":\"https://api-docs.tribalhabits.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tribal-habits/dbtAL_otpFb7lO5f/logo/light.png?fit=max\u0026auto=format\u0026n=dbtAL_otpFb7lO5f\u0026q=85\u0026s=27cd12465618e8e083443fe905630191\"}},{\"@type\":\"WebSite\",\"@id\":\"https://api-docs.tribalhabits.com#website\",\"name\":\"Tribal Habits API\",\"url\":\"https://api-docs.tribalhabits.com\",\"publisher\":{\"@id\":\"https://api-docs.tribalhabits.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://api-docs.tribalhabits.com/api-reference/external-knowledge/batch-create-external-knowledge#webpage\",\"url\":\"https://api-docs.tribalhabits.com/api-reference/external-knowledge/batch-create-external-knowledge\",\"name\":\"Batch create external knowledge\",\"description\":\"This endpoint creates multiple external knowledge records in one call. Each record accepts the same fields as Create a new external knowledge. Records are always created, not updated. The batch is saved as a whole: if any record fails, nothing is saved and the error for that record is returned. Maximum permitted batch size is 100.\",\"dateModified\":\"2026-10-08T04:12:39.993Z\",\"isPartOf\":{\"@id\":\"https://api-docs.tribalhabits.com#website\"},\"breadcrumb\":{\"@id\":\"https://api-docs.tribalhabits.com/api-reference/external-knowledge/batch-create-external-knowledge#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://api-docs.tribalhabits.com/api-reference/external-knowledge/batch-create-external-knowledge#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"External Knowledge\",\"item\":\"https://api-docs.tribalhabits.com/api-reference/external-knowledge/get-all-external-knowledge\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Batch create external knowledge\",\"item\":\"https://api-docs.tribalhabits.com/api-reference/external-knowledge/batch-create-external-knowledge\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://api-docs.tribalhabits.com/api-reference/external-knowledge/batch-create-external-knowledge#apireference\",\"headline\":\"Batch create external knowledge\",\"name\":\"Batch create external knowledge\",\"description\":\"This endpoint creates multiple external knowledge records in one call. Each record accepts the same fields as Create a new external knowledge. Records are always created, not updated. The batch is saved as a whole: if any record fails, nothing is saved and the error for that record is returned. Maximum permitted batch size is 100.\",\"url\":\"https://api-docs.tribalhabits.com/api-reference/external-knowledge/batch-create-external-knowledge\",\"mainEntityOfPage\":{\"@id\":\"https://api-docs.tribalhabits.com/api-reference/external-knowledge/batch-create-external-knowledge#webpage\"},\"dateModified\":\"2026-10-08T04:12:39.993Z\",\"publisher\":{\"@id\":\"https://api-docs.tribalhabits.com/#organization\"},\"isPartOf\":{\"@id\":\"https://api-docs.tribalhabits.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tribal Habits API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Tribal Habits API","nav":{"global":null,"groups":[{"group":"Getting started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Authentication","href":"/authentication"},{"title":"Vanity URL","href":"/vanity-url"},{"title":"Errors","href":"/errors"},{"title":"Rate limits","href":"/rate-limits"}]},{"group":"Users","pages":[{"title":"Custom fields","href":"/custom-fields"},{"title":"Get all users","deprecated":null,"version":null,"sidebarTitle":"Get all users","openapi":"/openapi.yaml get /users","href":"/api-reference/users/get-all-users"},{"title":"Create a new user","deprecated":null,"version":null,"sidebarTitle":"Create a new user","openapi":"/openapi.yaml post /users","href":"/api-reference/users/create-a-new-user"},{"title":"Get a specific user","deprecated":null,"version":null,"sidebarTitle":"Get a specific user","openapi":"/openapi.yaml get /users/{user_name}","href":"/api-reference/users/get-a-specific-user"},{"title":"Update a specific user","deprecated":null,"version":null,"sidebarTitle":"Update a specific user","openapi":"/openapi.yaml put /users/{user_name}","href":"/api-reference/users/update-a-specific-user"},{"title":"Batch create or update","deprecated":null,"version":null,"sidebarTitle":"Batch create or update","openapi":"/openapi.yaml post /users/batch_save","href":"/api-reference/users/batch-create-or-update"}]},{"group":"Topics","pages":[{"title":"Get all topics","deprecated":null,"version":null,"sidebarTitle":"Get all topics","openapi":"/openapi.yaml get /topics","href":"/api-reference/topics/get-all-topics"},{"title":"Get a specific topic","deprecated":null,"version":null,"sidebarTitle":"Get a specific topic","openapi":"/openapi.yaml get /topics/{id}","href":"/api-reference/topics/get-a-specific-topic"}]},{"group":"Pathways","pages":[{"title":"Get all pathways","deprecated":null,"version":null,"sidebarTitle":"Get all pathways","openapi":"/openapi.yaml get /pathways","href":"/api-reference/pathways/get-all-pathways"},{"title":"Get a specific pathway","deprecated":null,"version":null,"sidebarTitle":"Get a specific pathway","openapi":"/openapi.yaml get /pathways/{id}","href":"/api-reference/pathways/get-a-specific-pathway"}]},{"group":"Enrolments","pages":[{"title":"Get all topic enrolments","deprecated":null,"version":null,"sidebarTitle":"Get all topic enrolments","openapi":"/openapi.yaml get /topic_assignments","href":"/api-reference/enrolments/get-all-topic-enrolments"},{"title":"Get all topic enrolments by user","deprecated":null,"version":null,"sidebarTitle":"Get all topic enrolments by user","openapi":"/openapi.yaml get /topic_assignments/user/{user_name}","href":"/api-reference/enrolments/get-all-topic-enrolments-by-user"},{"title":"Get a specific topic enrolment","deprecated":null,"version":null,"sidebarTitle":"Get a specific topic enrolment","openapi":"/openapi.yaml get /topic_assignments/{id}","href":"/api-reference/enrolments/get-a-specific-topic-enrolment"},{"title":"Create or update topic or pathway enrolments","deprecated":null,"version":null,"sidebarTitle":"Create or update topic or pathway enrolments","openapi":"/openapi.yaml post /topic_assignments","href":"/api-reference/enrolments/create-or-update-topic-or-pathway-enrolments"},{"title":"Get all pathway enrolments","deprecated":null,"version":null,"sidebarTitle":"Get all pathway enrolments","openapi":"/openapi.yaml get /pathway_assignments","href":"/api-reference/enrolments/get-all-pathway-enrolments"},{"title":"Get all pathway enrolments by user","deprecated":null,"version":null,"sidebarTitle":"Get all pathway enrolments by user","openapi":"/openapi.yaml get /pathway_assignments/user/{user_name}","href":"/api-reference/enrolments/get-all-pathway-enrolments-by-user"},{"title":"Get a specific pathway enrolment","deprecated":null,"version":null,"sidebarTitle":"Get a specific pathway enrolment","openapi":"/openapi.yaml get /pathway_assignments/{id}","href":"/api-reference/enrolments/get-a-specific-pathway-enrolment"}]},{"group":"Certificates","pages":[{"title":"Certificates","href":"/certificates"},{"title":"Request a certificate","deprecated":null,"version":null,"sidebarTitle":"Request a certificate","openapi":"/openapi.yaml get /certificates","href":"/api-reference/certificates/request-a-certificate"},{"title":"Poll certificate status","deprecated":null,"version":null,"sidebarTitle":"Poll certificate status","openapi":"/openapi.yaml get /certificates/status/{job_id}","href":"/api-reference/certificates/poll-certificate-status"},{"title":"Download certificate PDF","api":"GET {url}","href":"/download-certificate"}]},{"group":"External Knowledge","pages":[{"title":"Get all external knowledge","deprecated":null,"version":null,"sidebarTitle":"Get all external knowledge","openapi":"/openapi.yaml get /external_knowledges","href":"/api-reference/external-knowledge/get-all-external-knowledge"},{"title":"Get a specific external knowledge","deprecated":null,"version":null,"sidebarTitle":"Get a specific external knowledge","openapi":"/openapi.yaml get /external_knowledges/{id}","href":"/api-reference/external-knowledge/get-a-specific-external-knowledge"},{"title":"Create a new external knowledge","deprecated":null,"version":null,"sidebarTitle":"Create a new external knowledge","openapi":"/openapi.yaml post /external_knowledges","href":"/api-reference/external-knowledge/create-a-new-external-knowledge"},{"title":"Update an external knowledge","description":"This endpoint updates an existing external knowledge record. Only fields that are supplied will be updated. The user cannot be changed with this endpoint. Skills and categories are only changed when the request includes them. To clear an optional field, send an empty string, eg `\"notes\": \"\"`. Returns `404` if the record does not exist.\n\n`id` is the unique identifier of an external knowledge record.\n\nThe country and region codes can be found in this site: [https://github.com/country-regions/country-region-data/blob/master/data.json](https://github.com/country-regions/country-region-data/blob/master/data.json)\n","deprecated":null,"version":null,"sidebarTitle":"Update an external knowledge","openapi":"/openapi.yaml put /external_knowledges/{id}","href":"/api-reference/external-knowledge/update-an-external-knowledge"},{"title":"Batch create external knowledge","deprecated":null,"version":null,"sidebarTitle":"Batch create external knowledge","openapi":"/openapi.yaml post /external_knowledges/batch_save","href":"/api-reference/external-knowledge/batch-create-external-knowledge"}]},{"group":"Webhooks","pages":[{"title":"Webhooks","description":"Get notified when events happen in Tribal Habits.","href":"/webhooks"},{"group":"Enrolment events","pages":[{"title":"Enrolment created","version":null,"deprecated":null,"openapi":"/openapi.yaml webhook enrolment-created","href":"/api-reference/webhooks/enrolment-created"},{"title":"Enrolment completed","version":null,"deprecated":null,"openapi":"/openapi.yaml webhook enrolment-completed","href":"/api-reference/webhooks/enrolment-completed"},{"title":"Enrolment updated","version":null,"deprecated":null,"openapi":"/openapi.yaml webhook enrolment-updated","href":"/api-reference/webhooks/enrolment-updated"},{"title":"Enrolment deleted","version":null,"deprecated":null,"openapi":"/openapi.yaml webhook enrolment-deleted","href":"/api-reference/webhooks/enrolment-deleted"}]}]}]},"basePath":"","title":"Batch create external knowledge - Tribal Habits API","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}