knowledge
Knowledge sources for AI Assistants: websites, pages, files, FAQs, catalogs; hybrid retrieval.
Knowledge sources for AI Assistants: websites, pages, files, FAQs, catalogs; hybrid retrieval.
| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | /v1/knowledge-sources | ai_kb_list_sources: List knowledge sources | ai:read | - |
| POST | /v1/knowledge-sources | knowledge_sources_create: Add a knowledge source (text, FAQ, URL, website crawl, file, catalog, Google Sheet) | ai:write | - |
| DELETE | /v1/knowledge-sources/{source_id} | ai_kb_delete_source: Delete a knowledge source and purge its chunks and embeddings | ai:write | - |
| GET | /v1/knowledge-sources/{source_id} | knowledge_sources_get: Get a knowledge source (chunk count, last sync, errors) | ai:read | - |
| PATCH | /v1/knowledge-sources/{source_id} | knowledge_sources_update: Update a knowledge source (assistants, title, re-crawl schedule) | ai:write | - |
| GET | /v1/knowledge-sources/{source_id}/documents | knowledge_documents_list: Documents under a source (pages, files, FAQ blocks) | ai:read | - |
| DELETE | /v1/knowledge-sources/{source_id}/documents/{document_id} | knowledge_documents_delete: Remove one document (its chunks are purged) | ai:write | - |
| GET | /v1/knowledge-sources/{source_id}/documents/{document_id} | knowledge_documents_get: Get one document under a source | ai:read | - |
| POST | /v1/knowledge-sources/{source_id}/resync | ai_kb_resync_source: Re-crawl / re-ingest a source (only changed pages are re-embedded and charged) | ai:write | - |
| POST | /v1/knowledge-sources/uploads | knowledge_sources_upload_create: Get a signed upload URL for a knowledge file (PDF, DOCX, CSV, text, or a spoken recording) | ai:write | - |
| POST | /v1/knowledge:search | ai_kb_search: Debug retrieval: top-k chunks with scores for a query | ai:read | - |
| GET | /v1/knowledge/gap-clusters | knowledge_gap_clusters_list: Clustered gaps with drafted articles | ai:read | - |
| POST | /v1/knowledge/gap-clusters/{cluster_id}/approve | knowledge_gap_cluster_approve: Approve the drafted article (one tap) and add it to the knowledge base | ai:write | - |
| POST | /v1/knowledge/gap-clusters/{cluster_id}/dismiss | knowledge_gap_cluster_dismiss: Dismiss a gap cluster | ai:write | - |
| GET | /v1/knowledge/gaps | knowledge_gaps_list: Questions the assistant could not answer | ai:read | - |
Request and response schemas: the interactive reference at https://api.wapitick.com/docs, or docs/api/openapi.json.