Knowledge Bases

A company has one default knowledge base (provisioned lazily on first use) and may have additional named KBs. Each KB is company-scoped and stamped with an immutable provider (default postgres).

List knowledge bases

GET /v1/brain

curl https://api.usenaive.ai/v1/brain \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "knowledge_bases": [
    { "id": "kb-uuid", "name": "Default Brain", "status": "active", "is_default": true, "created_at": "2026-07-01T00:00:00.000Z" }
  ],
  "count": 1
}

Create a knowledge base

POST /v1/brain

string

Name for the knowledge base (1–120 chars). Defaults to “Default Brain”.

boolean

Make this the company’s default knowledge base.

curl -X POST https://api.usenaive.ai/v1/brain \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "Engineering Docs", "is_default": false }'

{ "id": "kb-uuid", "name": "Engineering Docs", "status": "provisioning", "is_default": false }

Runtime status

GET /v1/brain/status — embed/answer/rerank/GBrain health plus KB/document/projection counts. Not plan-metered.

{
  "provider": "postgres",
  "semantic_engine": "gbrain",
  "embed": { "configured": true },
  "answer": { "configured": true },
  "gbrain": { "healthy": true, "mode": "engine" },
  "knowledge_bases": 2,
  "documents": 47,
  "projection": { "pending": 0, "failed": 0 }
}

Delete a knowledge base

DELETE /v1/brain/:id — deletes the KB and all its documents (permanent). Approval-gated for agent callers (returns 202 pending); returns a deletion receipt on completion.

curl -X DELETE https://api.usenaive.ai/v1/brain/kb-uuid \
  -H "Authorization: Bearer nv_sk_live_..."

{ "deleted": true, "receipt": { "provider": "postgres", "provider_confirmed": true, "verified": true, "deleted_at": "2026-07-09T12:00:00.000Z" } }

Overview

Endpoints

Knowledge Bases

List knowledge bases

Create a knowledge base

Runtime status

Delete a knowledge base

​List knowledge bases

​Create a knowledge base

​Runtime status

​Delete a knowledge base

List knowledge bases

Create a knowledge base

Runtime status

Delete a knowledge base