/arukz/api/v1.
1. Knowledge Ingestion & Connectors
| Capability | Description | Supporting Endpoints | Architecture Reference |
|---|---|---|---|
| GitHub / GitLab Connector | Ingests source code, markdown, and PRs with branch filtering and file globbing. | POST /knowledge/sources | Connectors Guide |
| Sitemap & Web Crawler | Same-origin crawler with robots.txt adherence and headless Chromium JS rendering. | POST /knowledge/sources | Web Sources |
| Workspace Wikis (Notion / Confluence) | OAuth sync preserving hierarchy breadcrumbs and markdown table schemas. | POST /knowledge/sources | Connectors Guide |
| Multipart File Uploads | Direct drag-and-drop for PDF, Word (.docx), Markdown, text, and OpenAPI specs. | POST /knowledge/uploads | File Uploads |
| Asynchronous Delta Sync | Background worker queue computing SHA-256 hashes to re-embed modified documents only. | POST /knowledge/sources/{id}/sync | Ingestion Guide |
| Live Job Telemetry | Real-time polling counters tracking document count, chunk count, and failures. | GET /knowledge/jobs/{id} | API Reference |
2. Retrieval, Grounding & Intelligence
| Capability | Description | Supporting Endpoints | Architecture Reference |
|---|---|---|---|
| Dual-Channel Hybrid Search | 3072-dimensional vector search merged with BM25 keyword matching via RRF. | Internal Query Engine | Retrieval Pipeline |
| Cross-Encoder Reranker | Cohere Rerank v3 and BGE-reranker scoring top 50 candidates down to top 5. | Internal Query Engine | Retrieval Pipeline |
| Cryptographic Prompt Fences | Per-request nonces shielding model prompts against indirect prompt injection. | AI Gateway | Inference Gateway |
| Strict Citation Grounding | Every answer maps claims directly to source titles, URLs, and excerpt passages. | POST /conversations/{id}/messages | How Answers Work |
| Honest Abstention Engine | Explicit refusal when evidence is absent, flagging gaps for technical writers. | POST /conversations/{id}/messages | How Answers Work |
| Semantic Response Cache | Sub-45ms memory cache deduplicating identical or semantically similar queries. | AI Gateway | Inference Gateway |
3. Channels & Developer Platform
| Capability | Description | Supporting Endpoints | Architecture Reference |
|---|---|---|---|
| White-Label Embeddable Widget | Drop-in JavaScript widget with custom brand palette, typography, and domain fencing. | GET /widget/bootstrap, POST /widget/start-thread | Widget Channel |
| Public REST API & Scoped Keys | Versioned HTTP API with SHA-256 stored keys and per-key rate limit buckets. | POST /api-keys, GET /api-keys | API Introduction |
| Model Context Protocol (MCP) | Standardized JSON-RPC server offering read-only knowledge tools for IDEs. | POST /mcp | MCP Channel |
| High-Throughput SSE Streaming | Real-time token streaming over Server-Sent Events with typing indicators. | POST /conversations/{id}/messages:stream | Streaming Reference |
| Multi-Turn Conversation State | Durable PostgreSQL conversation threads that survive application restarts. | GET /conversations, PATCH /conversations/{id} | Conversations API |
4. Security, Governance & Administration
| Capability | Description | Supporting Endpoints | Architecture Reference |
|---|---|---|---|
| Tenant Boundary Isolation | Hard PostgreSQL partition scoping where foreign tenant resources return 404. | All Endpoints | Organizations & Roles |
| Role-Based Access Control | Explicit authorization for Owner, Administrator, Editor, Member, and Widget Visitor. | GET /members, POST /members | Organizations & Roles |
| Groundedness & Gap Analytics | Aggregate usage telemetry and curated reports on unanswered customer queries. | GET /analytics/usage, GET /analytics/unanswered | Analytics Docs |
| White-Label Branding System | Tenant-specific SVG logos, favicon marks, and theme CSS color custom properties. | GET /branding, PUT /branding | Branding Guide |
| Audited Support Access | Customer-controlled temporary delegation window for vendor support engineers. | GET /support-access, POST /support-access | Support Access |
| Sovereign Air-Gapped Deployment | Complete containerized distribution with zero outbound phone-home pings. | GET /health, GET /ready | Sovereign Deployment |