Grants, changes, or revokes access on an existing Knowledge base. Targets are people and workspace API keys. Groups stay on the in-app Share Knowledge bases with the API flow.
API key scope: Requires an API key with the KNOWLEDGE_FOLDER_API scope. The API key itself needs the Editor role on the Knowledge base. See Share Knowledge bases with the API for setup instructions.
Knowledge bases: The Knowledge Folder API manages resources that appear as Knowledge bases in the Library.
A Viewer-only key, including a key that only has API search through the Knowledge base, cannot call these endpoints.An Editor workspace key can grant other qualifying workspace keys even if the key owner is not a workspace admin. The in-app Share dialog still lists API keys only for workspace admins.
User IDs and workspace API key IDs to grant. Minimum: 1. Maximum: 100.
role
string
Yes
USER or EDITOR
All IDs must resolve to a human workspace member or a qualifying workspace API key. Group IDs are not accepted. Personal API keys are not eligible. If any ID is missing or ineligible, the request fails and no grants are written.
You cannot change the Knowledge base owner’s access. Reassign ownership in the Library first. If the target has no grant yet, this request creates one.
Invalid body, ineligible share target, or owner access change
401
Invalid or missing API key
403
Missing KNOWLEDGE_FOLDER_API scope, or the key is not Editor on this Knowledge base
404
Knowledge base or access target not found
429
Rate limit exceeded
500
Unexpected server error
Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on API Key Best Practices.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Docs","colors":{"primary":"#4469FC","light":"#ECF0FF","dark":"#0D001D"},"logo":{"light":"https://mintcdn.com/langdock-34/URgvNwU7CYGZq8R7/logo/light.svg?fit=max\u0026auto=format\u0026n=URgvNwU7CYGZq8R7\u0026q=85\u0026s=594b4bd597e2629fb1a7dccfae6aa1c4","dark":"https://mintcdn.com/langdock-34/URgvNwU7CYGZq8R7/logo/dark.svg?fit=max\u0026auto=format\u0026n=URgvNwU7CYGZq8R7\u0026q=85\u0026s=d063d52fb4d331afb82adad972214673"},"favicon":"https://mintcdn.com/langdock-34/KbxhVmfYOcTup72x/favicon.png?fit=max\u0026auto=format\u0026n=KbxhVmfYOcTup72x\u0026q=85\u0026s=e12cd6cccfe5c94bf4ae6ea4fba7959c","background":{"color":{"dark":"#090014"}},"navbar":{"primary":{"type":"button","label":"Back to app","href":"https://app.langdock.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/langdock"}},"errors":{"404":{"redirect":true}},"contextual":{"options":["copy","view","mcp","cursor","vscode",{"title":"Ask Langdock","description":"Ask Langdock about the current page","icon":"/favicon.png","href":{"base":"https://app.langdock.com/chat","query":[{"key":"q","value":"Read from https://docs.langdock.com$path.md so I can ask questions about it."},{"key":"sendPrompt","value":"true"}]}}],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"newspaper","href":"https://www.langdock.com/changelog"},{"anchor":"Status","icon":"signal-bars","href":"https://status.langdock.com/"},{"anchor":"Support","icon":"messages-question","href":"https://www.langdock.com/contact-us"}]},"languages":[{"language":"en","default":true,"href":"en/using-langdock/get-started/introduction"},{"language":"de","href":"de/using-langdock/get-started/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"langdock-34","hasAudioNarration":false,"actualSubdomain":"langdock-34","customDomains":["docs.langdock.com"],"gitSource":{"type":"github","owner":"langdock","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae2596e5bd361c12dc2d13a","collectionId":"5b5dfdc5-7192-4208-bba1-253d72fae631","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae2596e5bd361c12dc2d13a"},"feedback":{"thumbs":true,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"DISABLED"},"CONTEXTUAL_FEEDBACK":{"status":"DISABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae2596e5bd361c12dc2d13a","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"en","tag":"Using Langdock","count":133},{"language":"de","tag":"Langdock nutzen","count":133},{"language":"en","tag":"Developer","count":118},{"language":"de","tag":"Entwickler","count":118},{"language":"en","tag":"Admin","count":100},{"language":"de","tag":"Admin","count":100},{"language":"en","tag":"Manage Integrations","count":43},{"language":"de","tag":"Integrationen verwalten","count":43},{"language":"en","tag":"Guides","count":40},{"language":"de","tag":"Anleitungen","count":40},{"language":"en","tag":"Workflows","count":28},{"language":"de","tag":"Workflows","count":28},{"language":"en","tag":"Billing API","count":19},{"language":"en","tag":"Integrations","count":19},{"language":"de","tag":"Billing API","count":19},{"language":"de","tag":"Integrationen","count":19},{"language":"en","tag":"Node Types","count":18},{"language":"de","tag":"Node Types","count":18},{"language":"en","tag":"Integration Setup Guides","count":17},{"language":"de","tag":"Integrations-Setup-Anleitungen","count":17}]},"assistantConfig":{"deflection":{"enabled":false}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/developer/knowledge-folder-api/share-access","slug":"/en/developer/knowledge-folder-api/share-access","pageMetadata":{"title":"Share Knowledge base access","description":"Grant, change, or revoke Knowledge base access for people and workspace API keys","openapi":"post /knowledge/{folderId}/access","keywords":["api","Knowledge bases","share","access","api key","roles"],"href":"/en/developer/knowledge-folder-api/share-access"},"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: \"Grant, change, or revoke Knowledge base access for people and workspace API keys\"\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,Info,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Grants, changes, or revokes access on an existing Knowledge base. Targets are people and workspace API keys. Groups stay on the in-app `,_jsx(_components.a,{href:`/en/developer/knowledge-folder-api/sharing`,children:`Share Knowledge bases with the API`}),` flow.`]}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before You Start`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`API key scope`}),`: Requires an API key with the `,_jsx(_components.code,{children:`KNOWLEDGE_FOLDER_API`}),` scope. The API key itself needs the Editor role on the Knowledge base. See `,_jsx(_components.a,{href:`/en/developer/knowledge-folder-api/sharing`,children:`Share Knowledge bases with the API`}),` for setup instructions.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Knowledge bases`}),`: The Knowledge Folder API manages resources that appear as Knowledge bases in the Library.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`base-url`,children:`Base URL`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://api.langdock.com`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Dedicated deployments`})}),_jsxs(_components.p,{children:[`Replace `,_jsx(_components.code,{children:`api.langdock.com`}),` with `,_jsx(_components.code,{children:`\u003cyour-deployment-url>/api/public`}),` in all requests.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`roles`,children:`Roles`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`API value`}),_jsx(_components.th,{children:`Library label`}),_jsx(_components.th,{children:`Access`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`USER`})}),_jsx(_components.td,{children:`Viewer`}),_jsx(_components.td,{children:`Search and retrieve files`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`EDITOR`})}),_jsx(_components.td,{children:`Editor`}),_jsx(_components.td,{children:`Upload, update, delete, share access, and rename`})]})]})]}),`\n`,_jsx(_components.p,{children:`A Viewer-only key, including a key that only has API search through the Knowledge base, cannot call these endpoints.`}),`\n`,_jsx(_components.p,{children:`An Editor workspace key can grant other qualifying workspace keys even if the key owner is not a workspace admin. The in-app Share dialog still lists API keys only for workspace admins.`}),`\n`,_jsx(Heading,{level:`2`,id:`grant-access`,children:`Grant access`}),`\n`,_jsx(_components.p,{children:_jsx(_components.code,{children:`POST /knowledge/{folderId}/access`})}),`\n`,_jsx(Heading,{level:`3`,id:`path-parameters`,children:`Path Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`folderId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`The ID of the Knowledge base`})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`request-body`,children:`Request Body`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`targetIds`})}),_jsx(_components.td,{children:`string[]`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`User IDs and workspace API key IDs to grant. Minimum: `,_jsx(_components.code,{children:`1`}),`. Maximum: `,_jsx(_components.code,{children:`100`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`role`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`USER`}),` or `,_jsx(_components.code,{children:`EDITOR`})]})]})]})]}),`\n`,_jsx(_components.p,{children:`All IDs must resolve to a human workspace member or a qualifying workspace API key. Group IDs are not accepted. Personal API keys are not eligible. If any ID is missing or ineligible, the request fails and no grants are written.`}),`\n`,_jsx(Heading,{level:`3`,id:`grant-with-curl`,children:`Grant with cURL`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,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:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.langdock.com/knowledge/{folderId}/access\"`}),_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 YOUR_API_KEY\"`}),_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:` \"Content-Type: application/json\"`}),_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:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"targetIds\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"7c9e6679-7425-40de-944b-e07fc1f90ae7\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"role\": \"EDITOR\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`grant-with-javascript`,children:`Grant with JavaScript`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`23`,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:`23`,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:` axios`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` require`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"axios\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`async`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` function`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` grantAccess`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`folderId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`targetIds`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`role`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_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:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` axios`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`post`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `https://api.langdock.com/knowledge/\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`folderId`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"/access`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`targetIds`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`role`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Bearer YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` );`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` return`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_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:` result`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` grantAccess`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"7c9e6679-7425-40de-944b-e07fc1f90ae7\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"EDITOR\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`result`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`result`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`granted`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`success-response-200-ok`,children:`Success Response (200 OK)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`17`,language:`json`,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:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`17`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"result\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"granted\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"USER\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"targetId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"7c9e6679-7425-40de-944b-e07fc1f90ae7\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"role\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"EDITOR\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"targetId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"role\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"EDITOR\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`change-a-role`,children:`Change a role`}),`\n`,_jsx(_components.p,{children:_jsx(_components.code,{children:`PATCH /knowledge/{folderId}/access`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`type`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`USER`}),` or `,_jsx(_components.code,{children:`API_KEY`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`targetId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`The person or workspace API key ID`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`role`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`USER`}),` or `,_jsx(_components.code,{children:`EDITOR`})]})]})]})]}),`\n`,_jsx(_components.p,{children:`You cannot change the Knowledge base owner’s access. Reassign ownership in the Library first. If the target has no grant yet, this request creates one.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,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:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PATCH`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.langdock.com/knowledge/{folderId}/access\"`}),_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 YOUR_API_KEY\"`}),_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:` \"Content-Type: application/json\"`}),_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:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\": \"API_KEY\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"targetId\": \"550e8400-e29b-41d4-a716-446655440000\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"role\": \"USER\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`json`,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:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`revoke-access`,children:`Revoke access`}),`\n`,_jsx(_components.p,{children:_jsx(_components.code,{children:`DELETE /knowledge/{folderId}/access`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`type`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`USER`}),` or `,_jsx(_components.code,{children:`API_KEY`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`targetId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`The person or workspace API key ID`})]})]})]}),`\n`,_jsx(_components.p,{children:`You cannot revoke the Knowledge base owner’s access.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,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:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` DELETE`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.langdock.com/knowledge/{folderId}/access\"`}),_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 YOUR_API_KEY\"`}),_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:` \"Content-Type: application/json\"`}),_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:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\": \"API_KEY\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"targetId\": \"550e8400-e29b-41d4-a716-446655440000\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`json`,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:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`error-handling`,children:`Error Handling`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:`Invalid body, ineligible share target, or owner access change`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`Invalid or missing API key`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsxs(_components.td,{children:[`Missing `,_jsx(_components.code,{children:`KNOWLEDGE_FOLDER_API`}),` scope, or the key is not Editor on this Knowledge base`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:`Knowledge base or access target not found`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`429`})}),_jsx(_components.td,{children:`Rate limit exceeded`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsx(_components.td,{children:`Unexpected server error`})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on `,_jsx(_components.a,{href:`/en/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices`,children:`API Key Best Practices`}),`.`]})})]})}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":"Share Knowledge base access","description":"Grant, change, or revoke Knowledge base access for people and workspace API keys","openapi":"post /knowledge/{folderId}/access","keywords":["api","Knowledge bases","share","access","api key","roles"],"href":"/en/developer/knowledge-folder-api/share-access"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before You Start","slug":"before-you-start","depth":2,"children":[]},{"title":"Base URL","slug":"base-url","depth":2,"children":[]},{"title":"Roles","slug":"roles","depth":2,"children":[]},{"title":"Grant access","slug":"grant-access","depth":2,"children":[{"title":"Path Parameters","slug":"path-parameters","depth":3,"children":[]},{"title":"Request Body","slug":"request-body","depth":3,"children":[]},{"title":"Grant with cURL","slug":"grant-with-curl","depth":3,"children":[]},{"title":"Grant with JavaScript","slug":"grant-with-javascript","depth":3,"children":[]},{"title":"Success Response (200 OK)","slug":"success-response-200-ok","depth":3,"children":[]}]},{"title":"Change a role","slug":"change-a-role","depth":2,"children":[]},{"title":"Revoke access","slug":"revoke-access","depth":2,"children":[]},{"title":"Error Handling","slug":"error-handling","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Grant Knowledge base access to people or workspace API keys","parameters":["cb0754b2-e2bd-41d3-b443-ead09c7d6300"],"requestBody":"47f1585d-6e69-4005-be61-055bbdbcbb2a","responses":{"200":"bc61fd99-ab21-450d-b992-c014ed858dd8"},"security":["0bbc69e3-8c85-48dc-bf69-1d675752c187"],"method":"post","type":"path","servers":["1381f949-6199-4dbd-84cd-46b83b072e11"],"path":"/knowledge/{folderId}/access","baseUrlOptions":["https://api.langdock.com"],"title":"Grant Knowledge base access to people or workspace API keys","description":"Grant, change, or revoke Knowledge base access for people and workspace API keys","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"cb0754b2-e2bd-41d3-b443-ead09c7d6300":{"name":"folderId","in":"path","required":true,"description":"The ID of the knowledge folder","schema":{"type":"string","isRequired":true,"description":"The ID of the knowledge folder","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["targetIds","role"],"properties":{"targetIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"targetIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"minItems":1,"maxItems":100,"isRequired":true,"uniqueKey":"targetIds","typeLabel":"string\u003cuuid>[]"},"role":{"type":"string","enum":["USER","EDITOR"],"isRequired":true,"uniqueKey":"role","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"targetIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"bc61fd99-ab21-450d-b992-c014ed858dd8":{"description":"Access granted successfully","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"0bbc69e3-8c85-48dc-bf69-1d675752c187":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key as Bearer token. Format \"Bearer YOUR_API_KEY\"","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"1381f949-6199-4dbd-84cd-46b83b072e11":{"url":"https://api.langdock.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key as Bearer token. Format \"Bearer YOUR_API_KEY\"","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key as Bearer token. Format \"Bearer YOUR_API_KEY\"","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"langdock-34","siteName":"Docs","title":"Share Knowledge base access - Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/developer/knowledge-folder-api/share-access","matchLevel":0},"de":{"href":"/de/developer/knowledge-folder-api/share-access","matchLevel":1}}},"lastModified":"2026-09-02T09:11:51.001Z","originalFileLocation":"en/developer/knowledge-folder-api/share-access.mdx","locale":"en"},"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=\"Grant, change, or revoke Knowledge base access for people and workspace API keys\">\u003cmeta data-mint-head name=\"application-name\" content=\"Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/langdock-34/8EMNQyrrZlRONhj1/_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/langdock-34/8EMNQyrrZlRONhj1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/langdock-34/8EMNQyrrZlRONhj1/_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/langdock-34/8EMNQyrrZlRONhj1/_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/langdock-34/8EMNQyrrZlRONhj1/_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/langdock-34/8EMNQyrrZlRONhj1/_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/langdock-34/8EMNQyrrZlRONhj1/_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/langdock-34/8EMNQyrrZlRONhj1/_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/langdock-34/8EMNQyrrZlRONhj1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Share Knowledge base access - Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Grant, change, or revoke Knowledge base access for people and workspace API keys\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.langdock.com/en/developer/knowledge-folder-api/share-access\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://langdock-34.mintlify.app/_mintlify/api/og/v2?division=Knowledge+Folder+API\u0026amp;title=Share+Knowledge+base+access\u0026amp;description=Grant%2C+change%2C+or+revoke+Knowledge+base+access+for+people+and+workspace+API+keys\u0026amp;theme=af251cb8027ba7e8fe3cc77e\u0026amp;signature=08cc01b4400d81c9d5192392a7ed517dcaa4dda659ddc7032b3c4700327e53b0\">\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=\"Share Knowledge base access - Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Grant, change, or revoke Knowledge base access for people and workspace API keys\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://langdock-34.mintlify.app/_mintlify/api/og/v2?division=Knowledge+Folder+API\u0026amp;title=Share+Knowledge+base+access\u0026amp;description=Grant%2C+change%2C+or+revoke+Knowledge+base+access+for+people+and+workspace+API+keys\u0026amp;theme=af251cb8027ba7e8fe3cc77e\u0026amp;signature=08cc01b4400d81c9d5192392a7ed517dcaa4dda659ddc7032b3c4700327e53b0\">\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/langdock-34/8EMNQyrrZlRONhj1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4469FC\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.langdock.com/en/developer/knowledge-folder-api/share-access\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/developer/knowledge-folder-api/share-access.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.langdock.com/en/developer/knowledge-folder-api/share-access\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.langdock.com/de/developer/knowledge-folder-api/share-access\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.langdock.com/en/developer/knowledge-folder-api/share-access\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.langdock.com/#organization\",\"name\":\"Docs\",\"url\":\"https://docs.langdock.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/langdock-34/URgvNwU7CYGZq8R7/logo/light.svg?fit=max\u0026auto=format\u0026n=URgvNwU7CYGZq8R7\u0026q=85\u0026s=594b4bd597e2629fb1a7dccfae6aa1c4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.langdock.com#website\",\"name\":\"Docs\",\"url\":\"https://docs.langdock.com\",\"publisher\":{\"@id\":\"https://docs.langdock.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.langdock.com/en/developer/knowledge-folder-api/share-access#webpage\",\"url\":\"https://docs.langdock.com/en/developer/knowledge-folder-api/share-access\",\"name\":\"Share Knowledge base access\",\"description\":\"Grant, change, or revoke Knowledge base access for people and workspace API keys\",\"dateModified\":\"2026-09-02T09:11:51.001Z\",\"isPartOf\":{\"@id\":\"https://docs.langdock.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.langdock.com/en/developer/knowledge-folder-api/share-access#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.langdock.com/en/developer/knowledge-folder-api/share-access#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Knowledge Folder API\",\"item\":\"https://docs.langdock.com/en/developer/knowledge-folder-api/knowledge-folder-overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Share Knowledge base access\",\"item\":\"https://docs.langdock.com/en/developer/knowledge-folder-api/share-access\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.langdock.com/en/developer/knowledge-folder-api/share-access#apireference\",\"headline\":\"Share Knowledge base access\",\"name\":\"Share Knowledge base access\",\"description\":\"Grant, change, or revoke Knowledge base access for people and workspace API keys\",\"url\":\"https://docs.langdock.com/en/developer/knowledge-folder-api/share-access\",\"mainEntityOfPage\":{\"@id\":\"https://docs.langdock.com/en/developer/knowledge-folder-api/share-access#webpage\"},\"dateModified\":\"2026-09-02T09:11:51.001Z\",\"keywords\":\"api, Knowledge bases, share, access, api key, roles\",\"publisher\":{\"@id\":\"https://docs.langdock.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.langdock.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Docs","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"newspaper","href":"https://www.langdock.com/changelog"},{"anchor":"Status","icon":"signal-bars","href":"https://status.langdock.com/"},{"anchor":"Support","icon":"messages-question","href":"https://www.langdock.com/contact-us"}]},"languages":[{"language":"en","default":true,"tabs":[{"tab":"Using Langdock","pages":[{"title":"Using Langdock","href":"/en/using-langdock/get-started/introduction"}]},{"tab":"Developer","groups":[{"group":"Overview","pages":[{"title":"API Introduction","href":"/en/developer/overview/api-introduction"},{"title":"Cookbook","href":"/en/developer/overview/cookbook"}]},{"group":"Completion API","pages":[{"title":"Completion API Overview","href":"/en/developer/completion-api/completion-overview"},{"title":"OpenAI Chat completion","openapi":"POST /openai/{region}/v1/chat/completions","href":"/en/developer/completion-api/openai"},{"title":"OpenAI Responses API","openapi":"POST /openai/{region}/v1/responses","href":"/en/developer/completion-api/openai-responses"},{"title":"OpenAI Image Generations","openapi":"POST /openai/{region}/v1/images/generations","href":"/en/developer/completion-api/openai-images"},{"title":"Anthropic Messages","openapi":"POST /anthropic/{region}/v1/messages","href":"/en/developer/completion-api/anthropic"},{"title":"Google Completion API","openapi":"POST /google/{region}/v1beta/models/{model}:generateContent","href":"/en/developer/completion-api/google"},{"title":"Codestral","openapi":"POST /mistral/{region}/v1/fim/completions","href":"/en/developer/completion-api/mistral"}]},{"group":"Embedding API","pages":[{"title":"OpenAI Embeddings","openapi":"POST /openai/{region}/v1/embeddings","href":"/en/developer/embedding-api/openai-embedding"}]},{"group":"Agents API","pages":[{"title":"Agents API Overview","href":"/en/developer/agents-api/agents-overview"},{"title":"Sharing Agents with API Keys","href":"/en/developer/agents-api/agent-api-guide"},{"title":"Agents Completions API","openapi":"POST /agent/v1/chat/completions","href":"/en/developer/agents-api/agent"},{"title":"Agent Get API","openapi":"GET /agent/v1/get","href":"/en/developer/agents-api/agent-get"},{"title":"Agent Create API","openapi":"POST /agent/v1/create","href":"/en/developer/agents-api/agent-create"},{"title":"Agent Update API","openapi":"PATCH /agent/v1/update","href":"/en/developer/agents-api/agent-update"},{"title":"Agent Publish API","openapi":"POST /agent/v1/publish","href":"/en/developer/agents-api/agent-publish"},{"title":"Agent Disable API","openapi":"PATCH /agent/v1/disable","href":"/en/developer/agents-api/agent-disable"},{"title":"Models for Agent API","openapi":"GET /agent/v1/models","href":"/en/developer/agents-api/agent-models"},{"title":"Upload Attachment API","openapi":"POST /attachment/v1/upload","href":"/en/developer/agents-api/upload-attachments"},{"title":"Delete Attachment API","openapi":"DELETE /attachment/v1/delete","href":"/en/developer/agents-api/delete-attachments"},{"title":"Agent Migration Guide","href":"/en/developer/agents-api/agent-migration"},{"title":"Migrating from Assistants API to Agents API","href":"/en/developer/agents-api/assistant-to-agent-migration"}]},{"group":"Integrations API","pages":[{"title":"Integrations API Overview","href":"/en/developer/integrations-api/integrations-overview"},{"title":"List Integrations","openapi":"GET /integrations/v1/get","href":"/en/developer/integrations-api/list-integrations"},{"title":"Create Integration","openapi":"POST /integrations/v1/create","href":"/en/developer/integrations-api/create-integration"},{"title":"Get Integration","openapi":"GET /integrations/v1/{integrationId}","href":"/en/developer/integrations-api/get-integration"},{"title":"Update Integration","openapi":"PATCH /integrations/v1/{integrationId}","href":"/en/developer/integrations-api/update-integration"},{"title":"Get Integration Icon","openapi":"GET /integrations/v1/{integrationId}/icon","href":"/en/developer/integrations-api/get-icon"},{"title":"Replace Integration Icon","openapi":"PUT /integrations/v1/{integrationId}/icon","href":"/en/developer/integrations-api/replace-icon"},{"title":"Update Auth Configuration","openapi":"PATCH /integrations/v1/{integrationId}/auth","href":"/en/developer/integrations-api/update-auth"},{"title":"Create Action","openapi":"POST /integrations/v1/{integrationId}/actions/create","href":"/en/developer/integrations-api/create-action"},{"title":"Update Action","openapi":"PUT /integrations/v1/{integrationId}/actions/{actionId}","href":"/en/developer/integrations-api/update-action"},{"title":"Delete Action","openapi":"DELETE /integrations/v1/{integrationId}/actions/{actionId}","href":"/en/developer/integrations-api/delete-action"},{"title":"Create Trigger","openapi":"POST /integrations/v1/{integrationId}/triggers/create","href":"/en/developer/integrations-api/create-trigger"},{"title":"Update Trigger","openapi":"PUT /integrations/v1/{integrationId}/triggers/{triggerId}","href":"/en/developer/integrations-api/update-trigger"},{"title":"Delete Trigger","openapi":"DELETE /integrations/v1/{integrationId}/triggers/{triggerId}","href":"/en/developer/integrations-api/delete-trigger"}]},{"group":"Skills API","pages":[{"title":"Skills API Overview","href":"/api-endpoints/skills/skills-overview"},{"title":"List Skills","openapi":"GET /skills/v1","href":"/api-endpoints/skills/list-skills"},{"title":"Create Skill","openapi":"POST /skills/v1","href":"/api-endpoints/skills/create-skill"},{"title":"Get Skill","openapi":"GET /skills/v1/{skillId}","href":"/api-endpoints/skills/get-skill"},{"title":"Get Skill File","openapi":"GET /skills/v1/{skillId}/files","href":"/api-endpoints/skills/get-skill-file"},{"title":"Update Skill","openapi":"PATCH /skills/v1/{skillId}","href":"/api-endpoints/skills/update-skill"},{"title":"Delete Skill","openapi":"DELETE /skills/v1/{skillId}","href":"/api-endpoints/skills/delete-skill"},{"title":"Import Skill","openapi":"POST /skills/v1/import","href":"/api-endpoints/skills/import-skill"}]},{"group":"Knowledge Folder API","pages":[{"title":"Knowledge Folder API Overview","href":"/en/developer/knowledge-folder-api/knowledge-folder-overview"},{"title":"Share Knowledge bases with the API","description":"The following guide explains how to create an API key in Langdock and share a Knowledge base with the API key.","href":"/en/developer/knowledge-folder-api/sharing"},{"title":"Share Knowledge base access","openapi":"post /knowledge/{folderId}/access","href":"/en/developer/knowledge-folder-api/share-access"},{"title":"List Knowledge bases","description":"List Knowledge bases a workspace API key can already use","openapi":"get /knowledge","href":"/en/developer/knowledge-folder-api/list-knowledge-folders"},{"title":"Upload File to Knowledge Folder","openapi":"post /knowledge/{folderId}","href":"/en/developer/knowledge-folder-api/upload-file"},{"title":"Update Attachment in Knowledge Folder","openapi":"patch /knowledge/{folderId}","href":"/en/developer/knowledge-folder-api/update-attachment"},{"title":"Update Knowledge base","openapi":"patch /knowledge/{folderId}/folder","href":"/en/developer/knowledge-folder-api/update-folder"},{"title":"Retrieve Files from Knowledge Folder","openapi":"get /knowledge/{folderId}/list","href":"/en/developer/knowledge-folder-api/retrieve-files"},{"title":"Delete Attachment from Knowledge Folder","openapi":"delete /knowledge/{folderId}/{attachmentId}","href":"/en/developer/knowledge-folder-api/delete-attachment"},{"title":"Search Knowledge bases","openapi":"post /knowledge/search","href":"/en/developer/knowledge-folder-api/search-knowledge-folder"}]},{"group":"Prompt Library API","pages":[{"title":"Prompt Library API Overview","href":"/en/developer/prompts-api/prompts-overview"},{"title":"List Prompts","openapi":"GET /prompts/v1","href":"/en/developer/prompts-api/list-prompts"},{"title":"Create Prompt","openapi":"POST /prompts/v1","href":"/en/developer/prompts-api/create-prompt"},{"title":"Get Prompt","openapi":"GET /prompts/v1/{promptId}","href":"/en/developer/prompts-api/get-prompt"},{"title":"Update Prompt","openapi":"PATCH /prompts/v1/{promptId}","href":"/en/developer/prompts-api/update-prompt"},{"title":"Delete Prompt","openapi":"DELETE /prompts/v1/{promptId}","href":"/en/developer/prompts-api/delete-prompt"},{"title":"List Prompt Folders","openapi":"GET /prompts/v1/folders","href":"/en/developer/prompts-api/list-folders"},{"title":"Create Prompt Folder","openapi":"POST /prompts/v1/folders","href":"/en/developer/prompts-api/create-folder"},{"title":"Get Prompt Folder","openapi":"GET /prompts/v1/folders/{folderId}","href":"/en/developer/prompts-api/get-folder"},{"title":"Update Prompt Folder","openapi":"PATCH /prompts/v1/folders/{folderId}","href":"/en/developer/prompts-api/update-folder"},{"title":"Delete Prompt Folder","openapi":"DELETE /prompts/v1/folders/{folderId}","href":"/en/developer/prompts-api/delete-folder"}]},{"group":"Usage Export API","pages":[{"title":"Usage Export API Overview","href":"/en/developer/usage-export-api/intro-to-usage-export-api"},{"title":"Export User Usage","openapi":"POST /export/users","href":"/en/developer/usage-export-api/export-users"},{"title":"Export Agent Usage","openapi":"POST /export/agents","href":"/en/developer/usage-export-api/export-agents"},{"title":"Export API Key Usage","openapi":"POST /export/api-keys","href":"/en/developer/usage-export-api/export-api-keys"},{"title":"Export Project Usage","openapi":"POST /export/projects","href":"/en/developer/usage-export-api/export-projects"},{"title":"Export Model Usage","openapi":"POST /export/models","href":"/en/developer/usage-export-api/export-models"},{"title":"Export Workflow Usage","openapi":"POST /export/workflows","href":"/en/developer/usage-export-api/export-workflows"}]},{"group":"Workflow API","pages":[{"title":"Workflow API Overview","href":"/en/developer/workflow-api/workflows-overview"},{"title":"List Workflows","openapi":"GET /workflows/v1/list","href":"/en/developer/workflow-api/list-workflows"},{"title":"Create Workflow","openapi":"POST /workflows/v1/create","href":"/en/developer/workflow-api/create-workflow"},{"title":"Get Workflow","openapi":"GET /workflows/v1/get","href":"/en/developer/workflow-api/get-workflow"},{"title":"Update Workflow","openapi":"PATCH /workflows/v1/update","href":"/en/developer/workflow-api/update-workflow"},{"title":"Publish Workflow","openapi":"POST /workflows/v1/publish","href":"/en/developer/workflow-api/publish-workflow"},{"title":"Delete Workflow","openapi":"DELETE /workflows/v1/delete","href":"/en/developer/workflow-api/delete-workflow"},{"title":"List Workflow Runs","openapi":"GET /workflows/v1/runs","href":"/en/developer/workflow-api/list-workflow-runs"},{"title":"Workflow Run Export API","openapi":"GET /workflows/{workflowId}/runs","href":"/en/developer/workflow-api/intro-to-workflow-api"}]},{"group":"Scheduled Tasks API","pages":[{"title":"Scheduled Tasks API Overview","href":"/en/developer/scheduled-tasks-api/scheduled-tasks-overview"},{"title":"List Scheduled Tasks","openapi":"GET /automations/v1","href":"/en/developer/scheduled-tasks-api/list-scheduled-tasks"},{"title":"Create Scheduled Task","openapi":"POST /automations/v1","href":"/en/developer/scheduled-tasks-api/create-scheduled-task"},{"title":"Get Scheduled Task","openapi":"GET /automations/v1/{automationId}","href":"/en/developer/scheduled-tasks-api/get-scheduled-task"},{"title":"Update Scheduled Task","openapi":"PATCH /automations/v1/{automationId}","href":"/en/developer/scheduled-tasks-api/update-scheduled-task"},{"title":"Delete Scheduled Task","openapi":"DELETE /automations/v1/{automationId}","href":"/en/developer/scheduled-tasks-api/delete-scheduled-task"},{"title":"Pause Scheduled Task","openapi":"POST /automations/v1/{automationId}/pause","href":"/en/developer/scheduled-tasks-api/pause-scheduled-task"},{"title":"Resume Scheduled Task","openapi":"POST /automations/v1/{automationId}/resume","href":"/en/developer/scheduled-tasks-api/resume-scheduled-task"},{"title":"Run Scheduled Task","openapi":"POST /automations/v1/{automationId}/run","href":"/en/developer/scheduled-tasks-api/run-scheduled-task"}]},{"group":"User Management API","pages":[{"title":"User Management API Overview","href":"/en/developer/user-management-api/user-management-overview"},{"title":"Invite Users","openapi":"POST /user-management/v1/invite","href":"/en/developer/user-management-api/invite"},{"title":"Update User Role","openapi":"POST /user-management/v1/update-user-role","href":"/en/developer/user-management-api/update-user-role"},{"title":"List Roles","openapi":"GET /user-management/v1/roles","href":"/en/developer/user-management-api/roles"},{"title":"Deactivate User","openapi":"POST /user-management/v1/deactivate-user","href":"/en/developer/user-management-api/deactivate-user"}]},{"group":"Billing API","pages":[{"title":"Billing API Overview","href":"/en/developer/billing-api/billing-api-overview"},{"title":"Get Billing Mode","openapi":"GET /billing/v1/mode","href":"/en/developer/billing-api/get-mode"},{"title":"Get Workspace Settings","openapi":"GET /billing/v1/bring-your-own-keys/settings","href":"/en/developer/billing-api/get-settings"},{"title":"Update Workspace Settings","openapi":"PATCH /billing/v1/bring-your-own-keys/settings","href":"/en/developer/billing-api/update-settings"},{"title":"Count Plan Members","openapi":"GET /billing/v1/bring-your-own-keys/plans","href":"/en/developer/billing-api/get-plans"},{"title":"List Users","openapi":"GET /billing/v1/bring-your-own-keys/users","href":"/en/developer/billing-api/list-users"},{"title":"Get User","openapi":"GET /billing/v1/bring-your-own-keys/users/{userId}","href":"/en/developer/billing-api/get-user"},{"title":"Set User Plan","openapi":"PUT /billing/v1/bring-your-own-keys/users/{userId}/plan","href":"/en/developer/billing-api/set-user-plan"},{"title":"Set User Extra Usage Budget","openapi":"PUT /billing/v1/bring-your-own-keys/users/{userId}/extra-usage-budget","href":"/en/developer/billing-api/set-user-extra-usage-budget"},{"title":"Bulk Set User Plans","openapi":"POST /billing/v1/bring-your-own-keys/users/plan/bulk","href":"/en/developer/billing-api/bulk-set-user-plans"},{"title":"List Usage Requests","openapi":"GET /billing/v1/bring-your-own-keys/usage-requests","href":"/en/developer/billing-api/list-usage-requests"},{"title":"Get Usage Request","openapi":"GET /billing/v1/bring-your-own-keys/usage-requests/{requestId}","href":"/en/developer/billing-api/get-usage-request"},{"title":"Decline Usage Request","openapi":"POST /billing/v1/bring-your-own-keys/usage-requests/{requestId}/dismiss","href":"/en/developer/billing-api/dismiss-usage-request"},{"title":"List Groups","openapi":"GET /billing/v1/bring-your-own-keys/groups","href":"/en/developer/billing-api/list-groups"},{"title":"Get Group","openapi":"GET /billing/v1/bring-your-own-keys/groups/{groupId}","href":"/en/developer/billing-api/get-group"},{"title":"Set Group Monthly Budget","openapi":"PUT /billing/v1/bring-your-own-keys/groups/{groupId}/monthly-budget","href":"/en/developer/billing-api/set-group-monthly-budget"},{"title":"List Agent Budgets","openapi":"GET /billing/v1/bring-your-own-keys/agents","href":"/en/developer/billing-api/list-agents"},{"title":"Get Agent Budget","openapi":"GET /billing/v1/bring-your-own-keys/agents/{agentId}","href":"/en/developer/billing-api/get-agent"},{"title":"Update Agent Budget","openapi":"PATCH /billing/v1/bring-your-own-keys/agents/{agentId}","href":"/en/developer/billing-api/update-agent-budget"}]},{"group":"Audit Logs API","pages":[{"title":"Audit Logs API Overview","href":"/en/developer/audit-logs-api/intro-to-audit-logs-api"},{"title":"List Audit Logs","openapi":"GET /audit-logs/{workspace_id}","href":"/en/developer/audit-logs-api/list-audit-logs"}]},{"group":"Compliance API","pages":[{"title":"Export tool parameters and outputs","href":"/en/developer/compliance-api/export-tool-results"}]}]},{"tab":"Admin","pages":[{"title":"Admin","href":"/en/admin/workspace/workspace"}]}]},{"language":"de","pages":[{"title":"de","href":"/de/developer/knowledge-folder-api/share-access"}]}]},"basePath":"","title":"Share Knowledge base access - Docs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}