Knowledge Bases

curl -X POST https://your-gateway/v1/kb \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "product-docs"}'

curl https://your-gateway/v1/kb \
  -H "Authorization: Bearer $KEY"

curl -X DELETE https://your-gateway/v1/kb/$KB_ID \
  -H "Authorization: Bearer $KEY"

curl -X POST https://your-gateway/v1/kb/$KB_ID/documents \
  -H "Authorization: Bearer $KEY" \
  -F "file=@document.pdf"

curl https://your-gateway/v1/kb/$KB_ID/documents \
  -H "Authorization: Bearer $KEY"

curl -X DELETE https://your-gateway/v1/kb/$KB_ID/documents/$DOC_ID \
  -H "Authorization: Bearer $KEY"

curl -X POST https://your-gateway/v1/kb/$KB_ID/query \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "How do I configure authentication?", "top_k": 5}'

{
  "results": [
    {
      "content": "Authentication is configured via the auth section...",
      "score": 0.92,
      "document_id": "doc_123",
      "metadata": {"source": "config-guide.md", "chunk_index": 3}
    }
  ]
}

curl -X POST https://your-gateway/w/ingest/url \
  -H "Cookie: session=..." \
  -H "Content-Type: application/json" \
  -d '{"kb_id": "<uuid>", "url": "https://example.com/article"}'

{
  "id": "<uuid>",
  "kb_id": "<uuid>",
  "name": "Article title or URL",
  "chunk_count": 12,
  "sha256": "...",
  "source_id": "https://example.com/article"
}