Knowledge API

Browse and read knowledge files from your Cognova workspace. Knowledge files are documents (Markdown, text, code, JSON) that agents reference during conversations.

List Files

GET /api/v1/knowledge

Returns all knowledge files in your workspace.

Response

{
  "data": [
    {
      "id": "uuid",
      "path": "docs/architecture.md",
      "title": "Architecture Overview",
      "mimeType": "text/markdown",
      "sizeBytes": 4523,
      "createdAt": "2026-03-10T14:30:00.000Z"
    }
  ]
}

Example

curl -H "Authorization: Bearer cg_YOUR_KEY" \
  https://cognova.dev/api/v1/knowledge

Get a File

GET /api/v1/knowledge/:path

Read a knowledge file by its virtual path. The path can include subdirectories.

Response

{
  "data": {
    "path": "docs/architecture.md",
    "title": "Architecture Overview",
    "content": "# Architecture\n\nOur system uses...",
    "mimeType": "text/markdown"
  }
}

Example

# Single file
curl -H "Authorization: Bearer cg_YOUR_KEY" \
  https://cognova.dev/api/v1/knowledge/docs/architecture.md

# Nested path
curl -H "Authorization: Bearer cg_YOUR_KEY" \
  https://cognova.dev/api/v1/knowledge/api/endpoints.json

How Knowledge Works

Upload files via the Cognova dashboard (Knowledge in the sidebar)
Assign knowledge directories to specific agents
During conversations, agents automatically retrieve relevant content from their knowledge base
The REST API and MCP server also expose knowledge for external tools

Knowledge files are stored in the database with virtual paths — there's no filesystem involved.