# 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`.
