Knowledge Platform

Data Plane Knowledge API

Tenant-scoped operations for AI applications:

POST /v1/ingest POST /v1/search POST /v1/retrieve GET /v1/documents GET /v1/manifests/{run_id}

Default port: :8080

Control Plane Landlord API

Platform administration — tenant lifecycle, API keys, monitoring:

POST /v1/tenants GET /v1/tenants POST /v1/api-keys GET /v1/landlord/health

Default port: :8081

Authentication

Knowledge API requires a tenant-scoped API key:

Authorization: Bearer kp_xxxxxxxxxxxxxxxx
X-API-Key: kp_xxxxxxxxxxxxxxxx

Onboard a Tenant

Create a new tenant (Landlord API, admin key required):

curl -X POST http://localhost:8081/v1/tenants \
  -H "Authorization: Bearer kp_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"My Tenant","slug":"my-tenant"}'

Ingest Content

curl -X POST http://localhost:8080/v1/ingest \
  -H "Authorization: Bearer kp_..." \
  -H "Content-Type: application/json" \
  -d '{"tenant_id":"default","content":"aXMgZW5ldnMga25vd2xlZGdl"}'

Search

curl -X POST http://localhost:8080/v1/search \
  -H "Authorization: Bearer kp_..." \
  -H "Content-Type: application/json" \
  -d '{"query":"knowledge","top_k":5}'