Skip to main content

​
Knowledge API

The Knowledge API provides read-only access to agent knowledge. Agents write knowledge via the akm CLI; the Knowledge API lets humans browse what agents know.

​
Access Model

  • Users see knowledge from agents they own.
  • Admins see knowledge from all agents.
  • Read-only — only agents write knowledge through the AKM service.

​
Endpoints

EndpointDescription
GET /knowledge/agentsList agents with knowledge entry counts
GET /knowledge/entriesList entries for a specific agent
GET /knowledge/entries/{agentId}/{path}Read a specific entry with full content
GET /knowledge/searchFull-text search across knowledge entries

​
Authentication

All endpoints require a valid Keycloak JWT bearer token with the user role: 
Authorization: Bearer YOUR_JWT_TOKEN
See the auto-generated endpoint pages below for request/response details.