Delete the source and all its page documents (asynchronous)
DELETE/v1/knowledge_bases/:kb_id/sources/:source_id
The source becomes deleting, a running sync is cancelled, and every page document is deleted like any other document (one knowledge.document.deleted webhook per page). Idempotent: 202 again while deleting.
Access: API key scope knowledge:write; portal users: organization admins and owners; the knowledge base in the path must be on the key's access list.
Request
Responses
- 202
- 403
- 404
Deletion accepted.
scope_missing, kb_not_in_allowlist, role_insufficient, actor_not_permitted, tenant_suspended, module_disabled (knowledge bases switched off on the platform: an operation that creates data or starts processing, for an organization that still has knowledge bases), web_sources_disabled, domain_blocked, domain_not_verified (website sources)
not_found (absent or owned by another organization — identical), module_disabled