Crawls the pages of a URL into the knowledge base and queues the first crawl at once. Each page becomes one
Markdown document that starts with "# <title>" and "Source: <url>"; its URL is stored on the document,
and its metadata holds urlSourceId. Re-crawls skip unchanged pages, update changed ones, add new ones and delete the documents of
pages that are gone; when a crawl finds fewer than half as many pages as the previous one, nothing is removed
and lastRun.warning says why. Within a knowledge base a page is held by one URL source only. robots.txt is
respected.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Dasha BlackBox Documentation","description":"Build, deploy, and monitor voice AI agents with Dasha BlackBox. Complete documentation for creating intelligent conversational AI agents with advanced voice capabilities.","colors":{"primary":"#4F46E5","light":"#6366F1","dark":"#312E81"},"logo":{"light":"https://mintcdn.com/dasha-628f9d33/OIOU150RbPNcpw0P/docs/logo-wordmark-light.svg?fit=max\u0026auto=format\u0026n=OIOU150RbPNcpw0P\u0026q=85\u0026s=d09a8bf9e3455eda1fccc003884b3cdf","dark":"https://mintcdn.com/dasha-628f9d33/OIOU150RbPNcpw0P/docs/logo-wordmark-dark.svg?fit=max\u0026auto=format\u0026n=OIOU150RbPNcpw0P\u0026q=85\u0026s=1a3ce52b54cb5126d7f2cd2a42c27fa3","href":"https://blackbox.dasha.ai"},"favicon":"https://mintcdn.com/dasha-628f9d33/PM9rl5FBZe1J7dH8/docs/logo.svg?fit=max\u0026auto=format\u0026n=PM9rl5FBZe1J7dH8\u0026q=85\u0026s=21c9365f53a83564419467531fb20a5d","api":{"playground":{"display":"interactive"},"examples":{"languages":["javascript","curl","python"]}},"navbar":{"links":[{"href":"https://dasha.ai","label":"Explore other Dasha products"},{"href":"mailto:support+blackbox@dasha.ai","label":"Get Support"}],"primary":{"type":"button","label":"Go to Dashboard","href":"https://blackbox.dasha.ai"}},"footer":{"socials":{"x":"https://x.com/dashaai_","linkedin":"https://www.linkedin.com/company/dashaai","github":"https://github.com/dasha-ai"},"links":[{"header":"Resources","items":[{"label":"Main Website","href":"https://dasha.ai"},{"label":"Dashboard","href":"https://blackbox.dasha.ai"},{"label":"Status","href":"https://status.dasha.ai"}]},{"header":"Support","items":[{"label":"Get Support","href":"mailto:support+blackbox@dasha.ai"}]}]},"search":{"prompt":"Search Dasha BlackBox docs..."},"seo":{"metatags":{"canonical":"https://blackbox.dasha.ai"},"indexing":"navigable"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":true},"integrations":{"posthog":{"apiKey":"phc_bF01JhDcDBEhCGS2wY8QMkGqrzgBQ25KxhcziHgwDvm","apiHost":"https://us.i.posthog.com"}},"errors":{"404":{"redirect":false,"title":"Page Not Found","description":"This page doesn't exist. Try using the search or navigation to find what you're looking for."}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Status","icon":"chart-line","href":"https://status.dasha.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dasha-628f9d33","hasAudioNarration":false,"actualSubdomain":"dasha-628f9d33","customDomains":["docs.blackbox.dasha.ai"],"gitSource":{"type":"github","owner":"dasha-ai","repo":"blackbox-docs","deployBranch":"production","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeafa53b434e7d02a3a2567","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":119},{"language":"default","tag":"Documentation","count":64},{"language":"default","tag":"Create","count":19},{"language":"default","tag":"Advanced Features","count":18},{"language":"default","tag":"Deploy","count":11},{"language":"default","tag":"Introduction","count":9},{"language":"default","tag":"Calls","count":9},{"language":"default","tag":"Misc","count":9},{"language":"default","tag":"WebIntegrations","count":9},{"language":"default","tag":"Document","count":8}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@dasha.ai"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base","slug":"/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base","pageMetadata":{"title":"Add a URL source to a knowledge base","description":"Crawls the pages of a URL into the knowledge base and queues the first crawl at once. Each page becomes one\nMarkdown document that starts with \"# \u003ctitle>\" and \"Source: \u003curl>\"; its URL is stored on the document,\nand its metadata holds urlSourceId. Re-crawls skip unchanged pages, update changed ones, add new ones and delete the documents of\npages that are gone; when a crawl finds fewer than half as many pages as the previous one, nothing is removed\nand lastRun.warning says why. Within a knowledge base a page is held by one URL source only. robots.txt is\nrespected.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/kb/{kbId}/sources","href":"/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base","autogeneratedByOpenApi":true},"description":"Crawls the pages of a URL into the knowledge base and queues the first crawl at once. Each page becomes one\nMarkdown document that starts with \"# \u003ctitle>\" and \"Source: \u003curl>\"; its URL is stored on the document,\nand its metadata holds urlSourceId. Re-crawls skip unchanged pages, update changed ones, add new ones and delete the documents of\npages that are gone; when a crawl finds fewer than half as many pages as the previous one, nothing is removed\nand lastRun.warning says why. Within a knowledge base a page is held by one URL source only. robots.txt is\nrespected.","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":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Add a URL source to a knowledge base","description":"Crawls the pages of a URL into the knowledge base and queues the first crawl at once. Each page becomes one\nMarkdown document that starts with \"# \u003ctitle>\" and \"Source: \u003curl>\"; its URL is stored on the document,\nand its metadata holds urlSourceId. Re-crawls skip unchanged pages, update changed ones, add new ones and delete the documents of\npages that are gone; when a crawl finds fewer than half as many pages as the previous one, nothing is removed\nand lastRun.warning says why. Within a knowledge base a page is held by one URL source only. robots.txt is\nrespected.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/kb/{kbId}/sources","href":"/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["KnowledgeBaseSource"],"summary":"Add a URL source to a knowledge base","description":"Crawls the pages of a URL into the knowledge base and queues the first crawl at once. Each page becomes one\nMarkdown document that starts with \"# \u003ctitle>\" and \"Source: \u003curl>\"; its URL is stored on the document,\nand its metadata holds urlSourceId. Re-crawls skip unchanged pages, update changed ones, add new ones and delete the documents of\npages that are gone; when a crawl finds fewer than half as many pages as the previous one, nothing is removed\nand lastRun.warning says why. Within a knowledge base a page is held by one URL source only. robots.txt is\nrespected.","parameters":["c76fedb9-0ddc-4518-996d-015de06938f4"],"requestBody":"8e1ec421-98dd-43ca-8133-dfd21107e7eb","responses":{"201":"d4d30fcf-2dd1-4711-b60e-3bc713bec3f7","400":"dc54a8e9-0ba9-4ec2-a006-cab23b19ee0a","404":"f204047f-e295-4ae0-87e4-8d979b775f7e","500":"5cee74b8-73a1-41a0-862c-e6185ff030f4"},"method":"post","type":"path","servers":["5fb0835c-a4f0-4503-aebe-00595f89e21f"],"security":["438e7f68-a155-42fd-8675-9d1199ae2693","bcfc7084-0b9a-4851-80ea-de419eddc013"],"path":"/api/v1/rag/kb/{kbId}/sources","baseUrlOptions":["https://blackbox.dasha.ai"],"title":"Add a URL source to a knowledge base","codeSamples":[],"requestExampleLanguages":["javascript","bash","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c76fedb9-0ddc-4518-996d-015de06938f4":{"name":"kbId","in":"path","description":"Knowledge base ID","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"Knowledge base ID","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"description":"The source","content":{"application/json-patch+json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","enum":["url"],"uniqueKey":"type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"enum\u003cstring> | null"},"url":{"oneOf":[{"type":"string","uniqueKey":"url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"url.oneOf.1","typeLabel":"null"}],"uniqueKey":"url","typeLabel":"string | null"},"scope":{"type":"string","enum":["section","page","site"],"uniqueKey":"scope","typeLabel":"enum\u003cstring>"},"pageLimit":{"type":"integer","format":"int32","uniqueKey":"pageLimit","typeLabel":"integer\u003cint32>"},"includePaths":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"includePaths.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"includePaths.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"includePaths.oneOf.1","typeLabel":"null"}],"uniqueKey":"includePaths","typeLabel":"string[] | null"},"excludePaths":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"excludePaths.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"excludePaths.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"excludePaths.oneOf.1","typeLabel":"null"}],"uniqueKey":"excludePaths","typeLabel":"string[] | null"},"recrawlIntervalHours":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"recrawlIntervalHours.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"recrawlIntervalHours.oneOf.1","typeLabel":"null"}],"uniqueKey":"recrawlIntervalHours","typeLabel":"integer\u003cint32> | null"},"crawlerName":{"oneOf":[{"type":"string","uniqueKey":"crawlerName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"crawlerName.oneOf.1","typeLabel":"null"}],"uniqueKey":"crawlerName","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"url","url":"\u003cstring>","pageLimit":123,"includePaths":["\u003cstring>"],"excludePaths":["\u003cstring>"],"recrawlIntervalHours":123,"crawlerName":"\u003cstring>"}}},"exampleType":"generated"},"application/json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","enum":["url"],"uniqueKey":"type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"enum\u003cstring> | null"},"url":{"oneOf":[{"type":"string","uniqueKey":"url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"url.oneOf.1","typeLabel":"null"}],"uniqueKey":"url","typeLabel":"string | null"},"scope":{"type":"string","enum":["section","page","site"],"uniqueKey":"scope","typeLabel":"enum\u003cstring>"},"pageLimit":{"type":"integer","format":"int32","uniqueKey":"pageLimit","typeLabel":"integer\u003cint32>"},"includePaths":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"includePaths.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"includePaths.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"includePaths.oneOf.1","typeLabel":"null"}],"uniqueKey":"includePaths","typeLabel":"string[] | null"},"excludePaths":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"excludePaths.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"excludePaths.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"excludePaths.oneOf.1","typeLabel":"null"}],"uniqueKey":"excludePaths","typeLabel":"string[] | null"},"recrawlIntervalHours":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"recrawlIntervalHours.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"recrawlIntervalHours.oneOf.1","typeLabel":"null"}],"uniqueKey":"recrawlIntervalHours","typeLabel":"integer\u003cint32> | null"},"crawlerName":{"oneOf":[{"type":"string","uniqueKey":"crawlerName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"crawlerName.oneOf.1","typeLabel":"null"}],"uniqueKey":"crawlerName","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"url","url":"\u003cstring>","pageLimit":123,"includePaths":["\u003cstring>"],"excludePaths":["\u003cstring>"],"recrawlIntervalHours":123,"crawlerName":"\u003cstring>"}}},"exampleType":"generated"},"text/json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","enum":["url"],"uniqueKey":"type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"enum\u003cstring> | null"},"url":{"oneOf":[{"type":"string","uniqueKey":"url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"url.oneOf.1","typeLabel":"null"}],"uniqueKey":"url","typeLabel":"string | null"},"scope":{"type":"string","enum":["section","page","site"],"uniqueKey":"scope","typeLabel":"enum\u003cstring>"},"pageLimit":{"type":"integer","format":"int32","uniqueKey":"pageLimit","typeLabel":"integer\u003cint32>"},"includePaths":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"includePaths.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"includePaths.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"includePaths.oneOf.1","typeLabel":"null"}],"uniqueKey":"includePaths","typeLabel":"string[] | null"},"excludePaths":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"excludePaths.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"excludePaths.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"excludePaths.oneOf.1","typeLabel":"null"}],"uniqueKey":"excludePaths","typeLabel":"string[] | null"},"recrawlIntervalHours":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"recrawlIntervalHours.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"recrawlIntervalHours.oneOf.1","typeLabel":"null"}],"uniqueKey":"recrawlIntervalHours","typeLabel":"integer\u003cint32> | null"},"crawlerName":{"oneOf":[{"type":"string","uniqueKey":"crawlerName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"crawlerName.oneOf.1","typeLabel":"null"}],"uniqueKey":"crawlerName","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"url","url":"\u003cstring>","pageLimit":123,"includePaths":["\u003cstring>"],"excludePaths":["\u003cstring>"],"recrawlIntervalHours":123,"crawlerName":"\u003cstring>"}}},"exampleType":"generated"},"application/*+json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","enum":["url"],"uniqueKey":"type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"enum\u003cstring> | null"},"url":{"oneOf":[{"type":"string","uniqueKey":"url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"url.oneOf.1","typeLabel":"null"}],"uniqueKey":"url","typeLabel":"string | null"},"scope":{"type":"string","enum":["section","page","site"],"uniqueKey":"scope","typeLabel":"enum\u003cstring>"},"pageLimit":{"type":"integer","format":"int32","uniqueKey":"pageLimit","typeLabel":"integer\u003cint32>"},"includePaths":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"includePaths.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"includePaths.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"includePaths.oneOf.1","typeLabel":"null"}],"uniqueKey":"includePaths","typeLabel":"string[] | null"},"excludePaths":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"excludePaths.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"excludePaths.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"excludePaths.oneOf.1","typeLabel":"null"}],"uniqueKey":"excludePaths","typeLabel":"string[] | null"},"recrawlIntervalHours":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"recrawlIntervalHours.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"recrawlIntervalHours.oneOf.1","typeLabel":"null"}],"uniqueKey":"recrawlIntervalHours","typeLabel":"integer\u003cint32> | null"},"crawlerName":{"oneOf":[{"type":"string","uniqueKey":"crawlerName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"crawlerName.oneOf.1","typeLabel":"null"}],"uniqueKey":"crawlerName","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"url","url":"\u003cstring>","pageLimit":123,"includePaths":["\u003cstring>"],"excludePaths":["\u003cstring>"],"recrawlIntervalHours":123,"crawlerName":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"d4d30fcf-2dd1-4711-b60e-3bc713bec3f7":{"description":"Created","content":{"text/plain":{"schema":{"required":["createdAt","excludePaths","id","includePaths","knowledgeBaseId","pageCount","pageLimit","scope","type","url"],"type":"object","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"knowledgeBaseId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"knowledgeBaseId","typeLabel":"string\u003cuuid>"},"type":{"type":"string","enum":["url"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"url":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"url","typeLabel":"string"},"scope":{"type":"string","enum":["section","page","site"],"isRequired":true,"uniqueKey":"scope","typeLabel":"enum\u003cstring>"},"pageLimit":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"pageLimit","typeLabel":"integer\u003cint32>"},"includePaths":{"type":"array","items":{"type":"string","uniqueKey":"includePaths.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"includePaths","typeLabel":"string[]"},"excludePaths":{"type":"array","items":{"type":"string","uniqueKey":"excludePaths.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"excludePaths","typeLabel":"string[]"},"pageCount":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"pageCount","typeLabel":"integer\u003cint32>"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"recrawlIntervalHours":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"recrawlIntervalHours.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"recrawlIntervalHours.oneOf.1","typeLabel":"null"}],"uniqueKey":"recrawlIntervalHours","typeLabel":"integer\u003cint32> | null"},"crawlerName":{"oneOf":[{"type":"string","uniqueKey":"crawlerName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"crawlerName.oneOf.1","typeLabel":"null"}],"uniqueKey":"crawlerName","typeLabel":"string | null"},"nextRunAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"nextRunAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"nextRunAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"nextRunAt","typeLabel":"string\u003cdate-time> | null"},"lastRun":{"oneOf":[{"type":"object","required":["counts","id","status","trigger"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"lastRun.oneOf.0.id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["queued","running","completed","failed"],"isRequired":true,"uniqueKey":"lastRun.oneOf.0.status","typeLabel":"enum\u003cstring>"},"trigger":{"type":"string","enum":["initial","scheduled","manual"],"isRequired":true,"uniqueKey":"lastRun.oneOf.0.trigger","typeLabel":"enum\u003cstring>"},"counts":{"type":"object","required":["covered","discovered","failed","fetched","removed","unchanged"],"properties":{"discovered":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.discovered","typeLabel":"integer\u003cint32>"},"fetched":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.fetched","typeLabel":"integer\u003cint32>"},"unchanged":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.unchanged","typeLabel":"integer\u003cint32>"},"failed":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.failed","typeLabel":"integer\u003cint32>"},"removed":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.removed","typeLabel":"integer\u003cint32>"},"covered":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.covered","typeLabel":"integer\u003cint32>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts","typeLabel":"object"},"startedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"lastRun.oneOf.0.startedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"lastRun.oneOf.0.startedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.startedAt","typeLabel":"string\u003cdate-time> | null"},"finishedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"lastRun.oneOf.0.finishedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"lastRun.oneOf.0.finishedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.finishedAt","typeLabel":"string\u003cdate-time> | null"},"error":{"oneOf":[{"type":"string","uniqueKey":"lastRun.oneOf.0.error.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"lastRun.oneOf.0.error.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.error","typeLabel":"string | null"},"errorCode":{"oneOf":[{"type":"string","enum":["not_configured","crawler_refused","page_allowance","crawler_failed"],"uniqueKey":"lastRun.oneOf.0.errorCode.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"lastRun.oneOf.0.errorCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.errorCode","typeLabel":"enum\u003cstring> | null"},"warning":{"oneOf":[{"type":"string","uniqueKey":"lastRun.oneOf.0.warning.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"lastRun.oneOf.0.warning.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.warning","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"lastRun.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"lastRun.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","knowledgeBaseId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","type":"url","url":"\u003cstring>","scope":"section","pageLimit":123,"includePaths":["\u003cstring>"],"excludePaths":["\u003cstring>"],"pageCount":123,"createdAt":"2023-11-07T05:31:56Z","recrawlIntervalHours":123,"crawlerName":"\u003cstring>","nextRunAt":"2023-11-07T05:31:56Z","lastRun":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"queued","trigger":"initial","counts":{"discovered":123,"fetched":123,"unchanged":123,"failed":123,"removed":123,"covered":123},"startedAt":"2023-11-07T05:31:56Z","finishedAt":"2023-11-07T05:31:56Z","error":"\u003cstring>","errorCode":"not_configured","warning":"\u003cstring>"}}}},"exampleType":"generated"},"application/json":{"schema":{"required":["createdAt","excludePaths","id","includePaths","knowledgeBaseId","pageCount","pageLimit","scope","type","url"],"type":"object","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"knowledgeBaseId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"knowledgeBaseId","typeLabel":"string\u003cuuid>"},"type":{"type":"string","enum":["url"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"url":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"url","typeLabel":"string"},"scope":{"type":"string","enum":["section","page","site"],"isRequired":true,"uniqueKey":"scope","typeLabel":"enum\u003cstring>"},"pageLimit":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"pageLimit","typeLabel":"integer\u003cint32>"},"includePaths":{"type":"array","items":{"type":"string","uniqueKey":"includePaths.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"includePaths","typeLabel":"string[]"},"excludePaths":{"type":"array","items":{"type":"string","uniqueKey":"excludePaths.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"excludePaths","typeLabel":"string[]"},"pageCount":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"pageCount","typeLabel":"integer\u003cint32>"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"recrawlIntervalHours":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"recrawlIntervalHours.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"recrawlIntervalHours.oneOf.1","typeLabel":"null"}],"uniqueKey":"recrawlIntervalHours","typeLabel":"integer\u003cint32> | null"},"crawlerName":{"oneOf":[{"type":"string","uniqueKey":"crawlerName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"crawlerName.oneOf.1","typeLabel":"null"}],"uniqueKey":"crawlerName","typeLabel":"string | null"},"nextRunAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"nextRunAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"nextRunAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"nextRunAt","typeLabel":"string\u003cdate-time> | null"},"lastRun":{"oneOf":[{"type":"object","required":["counts","id","status","trigger"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"lastRun.oneOf.0.id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["queued","running","completed","failed"],"isRequired":true,"uniqueKey":"lastRun.oneOf.0.status","typeLabel":"enum\u003cstring>"},"trigger":{"type":"string","enum":["initial","scheduled","manual"],"isRequired":true,"uniqueKey":"lastRun.oneOf.0.trigger","typeLabel":"enum\u003cstring>"},"counts":{"type":"object","required":["covered","discovered","failed","fetched","removed","unchanged"],"properties":{"discovered":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.discovered","typeLabel":"integer\u003cint32>"},"fetched":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.fetched","typeLabel":"integer\u003cint32>"},"unchanged":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.unchanged","typeLabel":"integer\u003cint32>"},"failed":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.failed","typeLabel":"integer\u003cint32>"},"removed":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.removed","typeLabel":"integer\u003cint32>"},"covered":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.covered","typeLabel":"integer\u003cint32>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts","typeLabel":"object"},"startedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"lastRun.oneOf.0.startedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"lastRun.oneOf.0.startedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.startedAt","typeLabel":"string\u003cdate-time> | null"},"finishedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"lastRun.oneOf.0.finishedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"lastRun.oneOf.0.finishedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.finishedAt","typeLabel":"string\u003cdate-time> | null"},"error":{"oneOf":[{"type":"string","uniqueKey":"lastRun.oneOf.0.error.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"lastRun.oneOf.0.error.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.error","typeLabel":"string | null"},"errorCode":{"oneOf":[{"type":"string","enum":["not_configured","crawler_refused","page_allowance","crawler_failed"],"uniqueKey":"lastRun.oneOf.0.errorCode.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"lastRun.oneOf.0.errorCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.errorCode","typeLabel":"enum\u003cstring> | null"},"warning":{"oneOf":[{"type":"string","uniqueKey":"lastRun.oneOf.0.warning.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"lastRun.oneOf.0.warning.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.warning","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"lastRun.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"lastRun.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","knowledgeBaseId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","type":"url","url":"\u003cstring>","scope":"section","pageLimit":123,"includePaths":["\u003cstring>"],"excludePaths":["\u003cstring>"],"pageCount":123,"createdAt":"2023-11-07T05:31:56Z","recrawlIntervalHours":123,"crawlerName":"\u003cstring>","nextRunAt":"2023-11-07T05:31:56Z","lastRun":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"queued","trigger":"initial","counts":{"discovered":123,"fetched":123,"unchanged":123,"failed":123,"removed":123,"covered":123},"startedAt":"2023-11-07T05:31:56Z","finishedAt":"2023-11-07T05:31:56Z","error":"\u003cstring>","errorCode":"not_configured","warning":"\u003cstring>"}}}},"exampleType":"generated"},"text/json":{"schema":{"required":["createdAt","excludePaths","id","includePaths","knowledgeBaseId","pageCount","pageLimit","scope","type","url"],"type":"object","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"knowledgeBaseId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"knowledgeBaseId","typeLabel":"string\u003cuuid>"},"type":{"type":"string","enum":["url"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"url":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"url","typeLabel":"string"},"scope":{"type":"string","enum":["section","page","site"],"isRequired":true,"uniqueKey":"scope","typeLabel":"enum\u003cstring>"},"pageLimit":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"pageLimit","typeLabel":"integer\u003cint32>"},"includePaths":{"type":"array","items":{"type":"string","uniqueKey":"includePaths.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"includePaths","typeLabel":"string[]"},"excludePaths":{"type":"array","items":{"type":"string","uniqueKey":"excludePaths.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"excludePaths","typeLabel":"string[]"},"pageCount":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"pageCount","typeLabel":"integer\u003cint32>"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"recrawlIntervalHours":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"recrawlIntervalHours.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"recrawlIntervalHours.oneOf.1","typeLabel":"null"}],"uniqueKey":"recrawlIntervalHours","typeLabel":"integer\u003cint32> | null"},"crawlerName":{"oneOf":[{"type":"string","uniqueKey":"crawlerName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"crawlerName.oneOf.1","typeLabel":"null"}],"uniqueKey":"crawlerName","typeLabel":"string | null"},"nextRunAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"nextRunAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"nextRunAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"nextRunAt","typeLabel":"string\u003cdate-time> | null"},"lastRun":{"oneOf":[{"type":"object","required":["counts","id","status","trigger"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"lastRun.oneOf.0.id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["queued","running","completed","failed"],"isRequired":true,"uniqueKey":"lastRun.oneOf.0.status","typeLabel":"enum\u003cstring>"},"trigger":{"type":"string","enum":["initial","scheduled","manual"],"isRequired":true,"uniqueKey":"lastRun.oneOf.0.trigger","typeLabel":"enum\u003cstring>"},"counts":{"type":"object","required":["covered","discovered","failed","fetched","removed","unchanged"],"properties":{"discovered":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.discovered","typeLabel":"integer\u003cint32>"},"fetched":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.fetched","typeLabel":"integer\u003cint32>"},"unchanged":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.unchanged","typeLabel":"integer\u003cint32>"},"failed":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.failed","typeLabel":"integer\u003cint32>"},"removed":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.removed","typeLabel":"integer\u003cint32>"},"covered":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts.covered","typeLabel":"integer\u003cint32>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"lastRun.oneOf.0.counts","typeLabel":"object"},"startedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"lastRun.oneOf.0.startedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"lastRun.oneOf.0.startedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.startedAt","typeLabel":"string\u003cdate-time> | null"},"finishedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"lastRun.oneOf.0.finishedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"lastRun.oneOf.0.finishedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.finishedAt","typeLabel":"string\u003cdate-time> | null"},"error":{"oneOf":[{"type":"string","uniqueKey":"lastRun.oneOf.0.error.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"lastRun.oneOf.0.error.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.error","typeLabel":"string | null"},"errorCode":{"oneOf":[{"type":"string","enum":["not_configured","crawler_refused","page_allowance","crawler_failed"],"uniqueKey":"lastRun.oneOf.0.errorCode.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"lastRun.oneOf.0.errorCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.errorCode","typeLabel":"enum\u003cstring> | null"},"warning":{"oneOf":[{"type":"string","uniqueKey":"lastRun.oneOf.0.warning.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"lastRun.oneOf.0.warning.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun.oneOf.0.warning","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"lastRun.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"lastRun.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastRun","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","knowledgeBaseId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","type":"url","url":"\u003cstring>","scope":"section","pageLimit":123,"includePaths":["\u003cstring>"],"excludePaths":["\u003cstring>"],"pageCount":123,"createdAt":"2023-11-07T05:31:56Z","recrawlIntervalHours":123,"crawlerName":"\u003cstring>","nextRunAt":"2023-11-07T05:31:56Z","lastRun":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"queued","trigger":"initial","counts":{"discovered":123,"fetched":123,"unchanged":123,"failed":123,"removed":123,"covered":123},"startedAt":"2023-11-07T05:31:56Z","finishedAt":"2023-11-07T05:31:56Z","error":"\u003cstring>","errorCode":"not_configured","warning":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"dc54a8e9-0ba9-4ec2-a006-cab23b19ee0a":{"description":"Bad Request","content":{"text/plain":{"schema":{"type":"object","properties":{"errors":{"oneOf":[{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.oneOf.0.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.oneOf.0.additionalProperties","typeLabel":"string[]"},"uniqueKey":"errors.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.oneOf.1.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.oneOf.1.additionalProperties","typeLabel":"string[]"},"uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":{},"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"},"application/json":{"schema":{"type":"object","properties":{"errors":{"oneOf":[{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.oneOf.0.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.oneOf.0.additionalProperties","typeLabel":"string[]"},"uniqueKey":"errors.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.oneOf.1.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.oneOf.1.additionalProperties","typeLabel":"string[]"},"uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":{},"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"},"text/json":{"schema":{"type":"object","properties":{"errors":{"oneOf":[{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.oneOf.0.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.oneOf.0.additionalProperties","typeLabel":"string[]"},"uniqueKey":"errors.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.oneOf.1.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.oneOf.1.additionalProperties","typeLabel":"string[]"},"uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":{},"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"f204047f-e295-4ae0-87e4-8d979b775f7e":{"description":"Not Found","content":{"text/plain":{"schema":{}},"application/json":{"schema":{}},"text/json":{"schema":{}}},"exampleType":"generated"},"5cee74b8-73a1-41a0-862c-e6185ff030f4":{"description":"Internal Server Error","content":{"text/plain":{"schema":{}},"application/json":{"schema":{}},"text/json":{"schema":{}}},"exampleType":"generated"}},"security":{"438e7f68-a155-42fd-8675-9d1199ae2693":{"ApiKey":{"type":"http","description":"API Key Authentication (Bearer {key})","scheme":"Bearer","scopes":[],"schemeName":"ApiKey"}},"bcfc7084-0b9a-4851-80ea-de419eddc013":{"OAuth":{"type":"oauth2","flows":{"implicit":{"authorizationUrl":"https://auth.dasha.ai/connect/authorize","scopes":{"platform_api":"Platform API"}}},"scopes":[],"schemeName":"OAuth"}}},"servers":{"5fb0835c-a4f0-4503-aebe-00595f89e21f":{"url":"https://blackbox.dasha.ai","description":"Dasha BlackBox Agent API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","description":"API Key Authentication (Bearer {key})","scheme":"Bearer","scopes":[],"schemeName":"ApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API Key Authentication (Bearer {key})","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKey","name":"Authorization"}],"title":"ApiKey"},{"schemes":[{"scheme":{"type":"oauth2","flows":{"implicit":{"authorizationUrl":"https://auth.dasha.ai/connect/authorize","scopes":{"platform_api":"Platform API"}}},"scopes":[],"schemeName":"OAuth"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"The access token received from the authorization server in the OAuth 2.0 flow.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OAuth","name":"Authorization"}],"title":"OAuth"}]},"originalFileLocation":"https://blackbox.dasha.ai/swagger/v1/swagger.json"},"subdomain":"dasha-628f9d33","siteName":"Dasha BlackBox Documentation","title":"Add a URL source to a knowledge base - Dasha BlackBox Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T09:27:36.279Z","originalFileLocation":"docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base.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=\"Crawls the pages of a URL into the knowledge base and queues the first crawl at once. Each page becomes one Markdown document that starts with \u0026quot;# \u0026quot; and \u0026quot;Source: \u0026quot;; its URL is stored on the document, and its metadata holds urlSourceId. Re-crawls skip unchanged pages, update changed ones, add new ones and delete the documents of pages that are gone; when a crawl finds fewer than half as many pages as the previous one, nothing is removed and lastRun.warning says why. Within a knowledge base a page is held by one URL source only. robots.txt is respected.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dasha BlackBox Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dasha-628f9d33/fTvoboiNZnitZ8gw/_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/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dasha-628f9d33/fTvoboiNZnitZ8gw/_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/dasha-628f9d33/fTvoboiNZnitZ8gw/_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/dasha-628f9d33/fTvoboiNZnitZ8gw/_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/dasha-628f9d33/fTvoboiNZnitZ8gw/_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/dasha-628f9d33/fTvoboiNZnitZ8gw/_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/dasha-628f9d33/fTvoboiNZnitZ8gw/_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/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add a URL source to a knowledge base - Dasha BlackBox Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Crawls the pages of a URL into the knowledge base and queues the first crawl at once. Each page becomes one Markdown document that starts with \u0026quot;# \u0026quot; and \u0026quot;Source: \u0026quot;; its URL is stored on the document, and its metadata holds urlSourceId. Re-crawls skip unchanged pages, update changed ones, add new ones and delete the documents of pages that are gone; when a crawl finds fewer than half as many pages as the previous one, nothing is removed and lastRun.warning says why. Within a knowledge base a page is held by one URL source only. robots.txt is respected.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dasha BlackBox Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://blackbox.dasha.ai/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dasha-628f9d33.mintlify.site/_mintlify/api/og/v2?division=KnowledgeBaseSource\u0026amp;title=Add+a+URL+source+to+a+knowledge+base\u0026amp;description=Crawls+the+pages+of+a+URL+into+the+knowledge+base+and+queues+the+first+crawl+at+once.+Each+page+becomes+one%0AMarkdown+document+that+starts+with+%22%23+%3Ctitle%3E%22+and+%22\u0026amp;theme=8f648b54f3a39a57bca8af12\u0026amp;signature=26102941e5ef94ea1b55aae747f2a84b59c7b42cd291f62ea0d7456a478f61c8\">\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=\"Add a URL source to a knowledge base - Dasha BlackBox Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Crawls the pages of a URL into the knowledge base and queues the first crawl at once. Each page becomes one Markdown document that starts with \u0026quot;# \u0026quot; and \u0026quot;Source: \u0026quot;; its URL is stored on the document, and its metadata holds urlSourceId. Re-crawls skip unchanged pages, update changed ones, add new ones and delete the documents of pages that are gone; when a crawl finds fewer than half as many pages as the previous one, nothing is removed and lastRun.warning says why. Within a knowledge base a page is held by one URL source only. robots.txt is respected.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dasha-628f9d33.mintlify.site/_mintlify/api/og/v2?division=KnowledgeBaseSource\u0026amp;title=Add+a+URL+source+to+a+knowledge+base\u0026amp;description=Crawls+the+pages+of+a+URL+into+the+knowledge+base+and+queues+the+first+crawl+at+once.+Each+page+becomes+one%0AMarkdown+document+that+starts+with+%22%23+%3Ctitle%3E%22+and+%22\u0026amp;theme=8f648b54f3a39a57bca8af12\u0026amp;signature=26102941e5ef94ea1b55aae747f2a84b59c7b42cd291f62ea0d7456a478f61c8\">\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/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dasha BlackBox Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4F46E5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://blackbox.dasha.ai/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://blackbox.dasha.ai/#organization\",\"name\":\"Dasha BlackBox Documentation\",\"url\":\"https://blackbox.dasha.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dasha-628f9d33/OIOU150RbPNcpw0P/docs/logo-wordmark-light.svg?fit=max\u0026auto=format\u0026n=OIOU150RbPNcpw0P\u0026q=85\u0026s=d09a8bf9e3455eda1fccc003884b3cdf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://blackbox.dasha.ai#website\",\"name\":\"Dasha BlackBox Documentation\",\"url\":\"https://blackbox.dasha.ai\",\"publisher\":{\"@id\":\"https://blackbox.dasha.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base#webpage\",\"url\":\"https://blackbox.dasha.ai/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base\",\"name\":\"Add a URL source to a knowledge base\",\"description\":\"Crawls the pages of a URL into the knowledge base and queues the first crawl at once. Each page becomes one Markdown document that starts with \\\"# \\\" and \\\"Source: \\\"; its URL is stored on the document, and its metadata holds urlSourceId. Re-crawls skip unchanged pages, update changed ones, add new ones and delete the documents of pages that are gone; when a crawl finds fewer than half as many pages as the previous one, nothing is removed and lastRun.warning says why. Within a knowledge base a page is held by one URL source only. robots.txt is respected.\",\"dateModified\":\"2026-11-04T09:27:36.279Z\",\"isPartOf\":{\"@id\":\"https://blackbox.dasha.ai#website\"},\"breadcrumb\":{\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"KnowledgeBaseSource\",\"item\":\"https://blackbox.dasha.ai/docs/api-reference/knowledgebasesource/list-the-url-sources-of-a-knowledge-base\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Add a URL source to a knowledge base\",\"item\":\"https://blackbox.dasha.ai/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base#apireference\",\"headline\":\"Add a URL source to a knowledge base\",\"name\":\"Add a URL source to a knowledge base\",\"description\":\"Crawls the pages of a URL into the knowledge base and queues the first crawl at once. Each page becomes one Markdown document that starts with \\\"# \\\" and \\\"Source: \\\"; its URL is stored on the document, and its metadata holds urlSourceId. Re-crawls skip unchanged pages, update changed ones, add new ones and delete the documents of pages that are gone; when a crawl finds fewer than half as many pages as the previous one, nothing is removed and lastRun.warning says why. Within a knowledge base a page is held by one URL source only. robots.txt is respected.\",\"url\":\"https://blackbox.dasha.ai/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base\",\"mainEntityOfPage\":{\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base#webpage\"},\"dateModified\":\"2026-11-04T09:27:36.279Z\",\"publisher\":{\"@id\":\"https://blackbox.dasha.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://blackbox.dasha.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dasha BlackBox Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Dasha BlackBox Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base.md","siteName":"Dasha BlackBox Documentation","nav":{"global":{"anchors":[{"anchor":"Status","icon":"chart-line","href":"https://status.dasha.ai"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/docs/introduction/what-is-blackbox"}]},{"tab":"API Reference","groups":[{"group":"ActivityLogs","pages":[{"title":"Search activity log","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/activity-logs/search","href":"/docs/api-reference/activitylogs/search-activity-log"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/agents","href":"/docs/api-reference/agents/list-agents"},{"title":"Create agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/agents","href":"/docs/api-reference/agents/create-agent"},{"title":"Get agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/agents/{agentId}","href":"/docs/api-reference/agents/get-agent"},{"title":"Update agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/agents/{agentId}","href":"/docs/api-reference/agents/update-agent"},{"title":"Delete agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/agents/{agentId}","href":"/docs/api-reference/agents/delete-agent"},{"title":"Clone agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/agents/{agentId}/clone","href":"/docs/api-reference/agents/clone-agent"},{"title":"Get agents linked to knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/agents/knowledge-base/list","href":"/docs/api-reference/agents/get-agents-linked-to-knowledge-base"}]},{"group":"AgentTestCases","pages":[]},{"group":"AgentToolTestResults","pages":[]},{"group":"CallResults","pages":[{"title":"Search call results","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/callresults/search","href":"/docs/api-reference/callresults/search-call-results"}]},{"group":"Calls","pages":[{"title":"Create call","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/calls","href":"/docs/api-reference/calls/create-call"},{"title":"Register inbound call","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/calls/register","href":"/docs/api-reference/calls/register-inbound-call"},{"title":"Create bulk calls","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/calls/bulk","href":"/docs/api-reference/calls/create-bulk-calls"},{"title":"Get call","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/{callId}","href":"/docs/api-reference/calls/get-call"},{"title":"Cancel call","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/calls/{callId}","href":"/docs/api-reference/calls/cancel-call"},{"title":"Get call queue","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/queue/list","href":"/docs/api-reference/calls/get-call-queue"},{"title":"Get call statistics","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/statistics/statuses","href":"/docs/api-reference/calls/get-call-statistics"},{"title":"Get call recording","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/media/{recordId}","href":"/docs/api-reference/calls/get-call-recording"},{"title":"Get SIP traces","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/{callId}/sip-traces","href":"/docs/api-reference/calls/get-sip-traces"}]},{"group":"Chats","pages":[{"title":"List chat sessions matching the supplied filters.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/chats","href":"/docs/api-reference/chats/list-chat-sessions-matching-the-supplied-filters"},{"title":"Open a new chat session.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/chats","href":"/docs/api-reference/chats/open-a-new-chat-session"},{"title":"Submit one user turn to an existing chat session.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/chats/{id}/messages","href":"/docs/api-reference/chats/submit-one-user-turn-to-an-existing-chat-session"},{"title":"Retrieve a chat session — full transcript and lifecycle status.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/chats/{id}","href":"/docs/api-reference/chats/retrieve-a-chat-session-—-full-transcript-and-lifecycle-status"},{"title":"End a chat session under the `user_end` reason.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/chats/{id}/end","href":"/docs/api-reference/chats/end-a-chat-session-under-the-`user_end`-reason"}]},{"group":"Copilot","pages":[]},{"group":"CustomerData","pages":[]},{"group":"Mcp","pages":[{"title":"Verify MCP connection","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/mcp/verify","href":"/docs/api-reference/mcp/verify-mcp-connection"}]},{"group":"Media","pages":[{"title":"List media files","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/media","href":"/docs/api-reference/media/list-media-files"},{"title":"Upload media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/media","href":"/docs/api-reference/media/upload-media-file"},{"title":"Get media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/media/{id}","href":"/docs/api-reference/media/get-media-file"},{"title":"Delete media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/media/{id}","href":"/docs/api-reference/media/delete-media-file"},{"title":"Update media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json patch /api/v1/media/{id}","href":"/docs/api-reference/media/update-media-file"},{"title":"Download media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/media/{id}/download","href":"/docs/api-reference/media/download-media-file"},{"title":"Get agents using media","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/media/{id}/affected-agents","href":"/docs/api-reference/media/get-agents-using-media"}]},{"group":"Misc","pages":[{"title":"Get server configuration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc","href":"/docs/api-reference/misc/get-server-configuration"},{"title":"Get current organization","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/me","href":"/docs/api-reference/misc/get-current-organization"},{"title":"Get concurrency limits","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/concurrency","href":"/docs/api-reference/misc/get-concurrency-limits"},{"title":"Get agent template","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/agent-initial-data","href":"/docs/api-reference/misc/get-agent-template"},{"title":"List predefined background sounds","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/background-sounds","href":"/docs/api-reference/misc/list-predefined-background-sounds"},{"title":"List predefined builtin media","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/builtin-media","href":"/docs/api-reference/misc/list-predefined-builtin-media"},{"title":"List predefined built-in tools","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/builtin-tools","href":"/docs/api-reference/misc/list-predefined-built-in-tools"},{"title":"Get platform capabilities","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/capabilities","href":"/docs/api-reference/misc/get-platform-capabilities"},{"title":"Get capabilities of available models","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/misc/capabilities","href":"/docs/api-reference/misc/get-capabilities-of-available-models"}]},{"group":"OpsDashboard","pages":[]},{"group":"PronunciationDictionaries","pages":[{"title":"List pronunciation dictionaries","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/pronunciation-dictionaries","href":"/docs/api-reference/pronunciationdictionaries/list-pronunciation-dictionaries"},{"title":"Create pronunciation dictionary","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/pronunciation-dictionaries","href":"/docs/api-reference/pronunciationdictionaries/create-pronunciation-dictionary"},{"title":"Get pronunciation dictionary","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/pronunciation-dictionaries/{providerId}","href":"/docs/api-reference/pronunciationdictionaries/get-pronunciation-dictionary"},{"title":"Delete pronunciation dictionary","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/pronunciation-dictionaries/{providerId}","href":"/docs/api-reference/pronunciationdictionaries/delete-pronunciation-dictionary"},{"title":"Add pronunciation rules","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/pronunciation-dictionaries/{providerId}/add-rules","href":"/docs/api-reference/pronunciationdictionaries/add-pronunciation-rules"},{"title":"Remove pronunciation rules","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/pronunciation-dictionaries/{providerId}/remove-rules","href":"/docs/api-reference/pronunciationdictionaries/remove-pronunciation-rules"},{"title":"Get agents using pronunciation dictionary","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/pronunciation-dictionaries/{providerId}/affected-agents","href":"/docs/api-reference/pronunciationdictionaries/get-agents-using-pronunciation-dictionary"}]},{"group":"Providers","pages":[{"title":"List providers","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/providers","href":"/docs/api-reference/providers/list-providers"},{"title":"Get provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/providers/{id}","href":"/docs/api-reference/providers/get-provider"},{"title":"Delete provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/providers/{id}","href":"/docs/api-reference/providers/delete-provider"},{"title":"Verify provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/providers/{id}/verify","href":"/docs/api-reference/providers/verify-provider"}]},{"group":"SipAliases","pages":[]},{"group":"SipCredentials","pages":[{"title":"List SIP credentials","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-credentials","href":"/docs/api-reference/sipcredentials/list-sip-credentials"},{"title":"Create SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/sip-credentials","href":"/docs/api-reference/sipcredentials/create-sip-credential"},{"title":"Get SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-credentials/{id}","href":"/docs/api-reference/sipcredentials/get-sip-credential"},{"title":"Update SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/sip-credentials/{id}","href":"/docs/api-reference/sipcredentials/update-sip-credential"},{"title":"Delete SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/sip-credentials/{id}","href":"/docs/api-reference/sipcredentials/delete-sip-credential"},{"title":"Get agents using SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-credentials/{id}/affected-agents","href":"/docs/api-reference/sipcredentials/get-agents-using-sip-credential"}]},{"group":"SipDomains","pages":[{"title":"List custom SIP domains","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-domains","href":"/docs/api-reference/sipdomains/list-custom-sip-domains"},{"title":"Add custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/sip-domains","href":"/docs/api-reference/sipdomains/add-custom-sip-domain"},{"title":"Get custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-domains/{id}","href":"/docs/api-reference/sipdomains/get-custom-sip-domain"},{"title":"Delete custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/sip-domains/{id}","href":"/docs/api-reference/sipdomains/delete-custom-sip-domain"},{"title":"Update inbound routing of a custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json patch /api/v1/sip-domains/{id}","href":"/docs/api-reference/sipdomains/update-inbound-routing-of-a-custom-sip-domain"},{"title":"Verify custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/sip-domains/{id}/verify","href":"/docs/api-reference/sipdomains/verify-custom-sip-domain"}]},{"group":"SipPhoneNumbers","pages":[{"title":"List phone numbers","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-phone-numbers","href":"/docs/api-reference/sipphonenumbers/list-phone-numbers"},{"title":"Create phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/sip-phone-numbers","href":"/docs/api-reference/sipphonenumbers/create-phone-number"},{"title":"Get phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-phone-numbers/{id}","href":"/docs/api-reference/sipphonenumbers/get-phone-number"},{"title":"Update phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/sip-phone-numbers/{id}","href":"/docs/api-reference/sipphonenumbers/update-phone-number"},{"title":"Delete phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/sip-phone-numbers/{id}","href":"/docs/api-reference/sipphonenumbers/delete-phone-number"},{"title":"Link phone number to agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/sip-phone-numbers/{id}/agent-link","href":"/docs/api-reference/sipphonenumbers/link-phone-number-to-agent"},{"title":"Unlink phone number from agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/sip-phone-numbers/{id}/agent-link","href":"/docs/api-reference/sipphonenumbers/unlink-phone-number-from-agent"},{"title":"Get agents using phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-phone-numbers/{id}/affected-agents","href":"/docs/api-reference/sipphonenumbers/get-agents-using-phone-number"}]},{"group":"SipRegisterCallWebhook","pages":[]},{"group":"TextChat","pages":[{"title":"Run one stateless text-chat completion turn.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/text-chat/completion","href":"/docs/api-reference/textchat/run-one-stateless-text-chat-completion-turn"}]},{"group":"TwilioProvider","pages":[{"title":"Get Twilio provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/providers/twilio/{id}","href":"/docs/api-reference/twilioprovider/get-twilio-provider"},{"title":"Update Twilio provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/providers/twilio/{id}","href":"/docs/api-reference/twilioprovider/update-twilio-provider"},{"title":"Create Twilio provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/providers/twilio","href":"/docs/api-reference/twilioprovider/create-twilio-provider"},{"title":"Update Auth Token","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json patch /api/v1/providers/twilio/{id}/auth-token","href":"/docs/api-reference/twilioprovider/update-auth-token"},{"title":"List available phone numbers","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/providers/twilio/{id}/available-numbers","href":"/docs/api-reference/twilioprovider/list-available-phone-numbers"},{"title":"Import phone numbers","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/providers/twilio/{id}/import-numbers","href":"/docs/api-reference/twilioprovider/import-phone-numbers"},{"title":"Remove phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/providers/twilio/{id}/phone-numbers/{phoneNumberId}","href":"/docs/api-reference/twilioprovider/remove-phone-number"}]},{"group":"Voice","pages":[{"title":"List available voices","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/voice","href":"/docs/api-reference/voice/list-available-voices"},{"title":"Synthesize text to speech","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/voice/synthesize","href":"/docs/api-reference/voice/synthesize-text-to-speech"},{"title":"Get built-in sound audio","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/voice/builtin-media","href":"/docs/api-reference/voice/get-built-in-sound-audio"},{"title":"Clone voice from audio","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/voice/clone","href":"/docs/api-reference/voice/clone-voice-from-audio"},{"title":"Delete cloned voice","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/voice/clone/{voiceId}","href":"/docs/api-reference/voice/delete-cloned-voice"},{"title":"Update cloned voice","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json patch /api/v1/voice/clone/{voiceId}","href":"/docs/api-reference/voice/update-cloned-voice"}]},{"group":"WebhookTest","pages":[{"title":"Test webhook endpoint","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/webhooks/test","href":"/docs/api-reference/webhooktest/test-webhook-endpoint"}]},{"group":"WebIntegrations","pages":[{"title":"List web integrations","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/web-integrations","href":"/docs/api-reference/webintegrations/list-web-integrations"},{"title":"Update web integration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/web-integrations","href":"/docs/api-reference/webintegrations/update-web-integration"},{"title":"Create web integration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/web-integrations","href":"/docs/api-reference/webintegrations/create-web-integration"},{"title":"Get web integrations by agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/web-integrations/agent","href":"/docs/api-reference/webintegrations/get-web-integrations-by-agent"},{"title":"Get web integration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/web-integrations/integration","href":"/docs/api-reference/webintegrations/get-web-integration"},{"title":"Delete web integration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/web-integrations/{integrationId}","href":"/docs/api-reference/webintegrations/delete-web-integration"},{"title":"Create integration token","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/web-integrations/{integrationId}/tokens","href":"/docs/api-reference/webintegrations/create-integration-token"},{"title":"Delete integration token","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/web-integrations/{integrationId}/tokens/{tokenId}","href":"/docs/api-reference/webintegrations/delete-integration-token"},{"title":"Validate integration token","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/web-integrations/discover","href":"/docs/api-reference/webintegrations/validate-integration-token"}]},{"group":"WebSocket","pages":[{"title":"WebSocket endpoint for web calls","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/ws/webCall","href":"/docs/api-reference/websocket/websocket-endpoint-for-web-calls"},{"title":"Get WebSocket endpoint information","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/ws/info","href":"/docs/api-reference/websocket/get-websocket-endpoint-information"}]},{"group":"Document","pages":[{"title":"List documents in a knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document","href":"/docs/api-reference/document/list-documents-in-a-knowledge-base"},{"title":"Upload a document to a knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/document","href":"/docs/api-reference/document/upload-a-document-to-a-knowledge-base"},{"title":"Get document details with status","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document/{id}","href":"/docs/api-reference/document/get-document-details-with-status"},{"title":"Update a document content in KB","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/document/{id}","href":"/docs/api-reference/document/update-a-document-content-in-kb"},{"title":"Delete a document","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/rag/document/{id}","href":"/docs/api-reference/document/delete-a-document"},{"title":"Get document chunks","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document/{id}/chunks","href":"/docs/api-reference/document/get-document-chunks"},{"title":"Get document chunk information","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document/chunks/{chunkId}","href":"/docs/api-reference/document/get-document-chunk-information"},{"title":"Download document content","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document/{id}/download","href":"/docs/api-reference/document/download-document-content"}]},{"group":"KnowledgeBase","pages":[{"title":"Get all knowledge","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb","href":"/docs/api-reference/knowledgebase/get-all-knowledge"},{"title":"Create a new knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/kb","href":"/docs/api-reference/knowledgebase/create-a-new-knowledge-base"},{"title":"Get knowledge base details with statistics","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb/{id}","href":"/docs/api-reference/knowledgebase/get-knowledge-base-details-with-statistics"},{"title":"Update knowledge base settings","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/rag/kb/{id}","href":"/docs/api-reference/knowledgebase/update-knowledge-base-settings"},{"title":"Delete a knowledge base and all its content","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/rag/kb/{id}","href":"/docs/api-reference/knowledgebase/delete-a-knowledge-base-and-all-its-content"}]},{"group":"KnowledgeBaseSource","pages":[{"title":"List the URL sources of a knowledge base","description":null,"deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb/{kbId}/sources","href":"/docs/api-reference/knowledgebasesource/list-the-url-sources-of-a-knowledge-base"},{"title":"Add a URL source to a knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/kb/{kbId}/sources","href":"/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base"},{"title":"Get a URL source","description":"Returns the source, when its next automatic re-crawl starts, and its latest crawl with page counts. Poll it to\nfollow a crawl from \"queued\" through \"running\" to \"completed\" or \"failed\".","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb/{kbId}/sources/{sourceId}","href":"/docs/api-reference/knowledgebasesource/get-a-url-source"},{"title":"Update the settings of a URL source","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/rag/kb/{kbId}/sources/{sourceId}","href":"/docs/api-reference/knowledgebasesource/update-the-settings-of-a-url-source"},{"title":"Remove a URL source","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/rag/kb/{kbId}/sources/{sourceId}","href":"/docs/api-reference/knowledgebasesource/remove-a-url-source"},{"title":"Crawl a URL source now","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/kb/{kbId}/sources/{sourceId}/crawl","href":"/docs/api-reference/knowledgebasesource/crawl-a-url-source-now"},{"title":"List the pages of a URL source","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb/{kbId}/sources/{sourceId}/pages","href":"/docs/api-reference/knowledgebasesource/list-the-pages-of-a-url-source"},{"title":"Get the page usage of all URL sources","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/sources/usage","href":"/docs/api-reference/knowledgebasesource/get-the-page-usage-of-all-url-sources"}]},{"group":"Search","pages":[{"title":"Search within a multi knowledge bases","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/search","href":"/docs/api-reference/search/search-within-a-multi-knowledge-bases"}]}]}]},"basePath":"","title":"Add a URL source to a knowledge base - Dasha BlackBox Documentation","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}