Knowledge Bases

Create and manage isolated knowledge containers. Each KnowledgeDB holds documents and images in its own namespace.

POST

Create Knowledge Base

/knowledgedbs

Create a new knowledge base to organize your documents and data.

Request Parameters

namestring*Name for the knowledge base.

descriptionstringOptional description.

Response Fields

messagestringSuccess confirmation.

knowledgeDbIdstringUnique ID of the created knowledge base.

// POST /knowledgedbs
// Authorization: Bearer <idToken>
// x-api-key: <apiKey>
{
  "name": "My Research",
  "description": "Research papers and notes"
}

GET

List Knowledge Bases

/knowledgedbs

Retrieve all knowledge bases belonging to the authenticated user.

Response Fields

knowledgedbsarrayArray of knowledge base objects.

countnumberTotal number of knowledge bases.

// GET /knowledgedbs
// 200 OK
{
  "knowledgedbs": [
    {
      "knowledgeDbId": "kb_abc123",
      "name": "My Research",
      "description": "Research papers",
      "documentCount": 5,
      "createdAt": "2026-01-15T10:30:00Z"
    }
  ],
  "count": 1
}

DELETE

Delete Knowledge Base

/knowledgedbs/{knowledgeDbId}

Delete a knowledge base and all its associated documents and data. This action is irreversible.

ℹ️This permanently deletes all documents, embeddings, and data within the knowledge base.

// DELETE /knowledgedbs/{knowledgeDbId}
// Authorization: Bearer <idToken>
// x-api-key: <apiKey>