Knowledge Tree API v1

A single REST API for every resource and relationship you own.

Query the graph, trigger discovery, generate documentation, stream chat responses, and administer the platform — all over a consistent, JSON-first, JWT-authenticated HTTP API.

Endpoints
36+
Auth
JWT bearer
Base URL
api.knowledgetree.dev

Resource groups

Health

2 endpoints

Health and readiness probes for load balancers and orchestrators.

GET/healthGET/ready

Auth

3 endpoints

Authentication and session endpoints. JWT bearer tokens are used for all privileged routes.

POST/api/v1/auth/loginPOST/api/v1/auth/logoutGET/api/v1/auth/me

Services

4 endpoints

Service catalog, detail, runbooks, and blast-radius impact analysis.

GET/api/v1/servicesGET/api/v1/services/{name}GET/api/v1/services/{name}/impactGET/api/v1/services/{name}/runbook

Graph

4 endpoints

Query the knowledge graph with Cypher, traverse edges, and export topology.

POST/api/v1/graph/queryGET/api/v1/graph/nodesGET/api/v1/graph/nodes/{id}GET/api/v1/graph/topology

Discovery

5 endpoints

Manage discovery scopes and runs across all providers.

GET/api/v1/scopesPOST/api/v1/scopesPOST/api/v1/scopes/{id}/runGET/api/v1/runs+1 more

Docs

3 endpoints

Trigger documentation generation and search generated documents.

POST/api/v1/docs/generateGET/api/v1/docs/searchGET/api/v1/docs/{path}

Changes

2 endpoints

Infrastructure change feed produced by diffing consecutive runs.

GET/api/v1/changesGET/api/v1/changes/{id}

Plugins

3 endpoints

Install, enable, configure, and introspect discovery plugins.

GET/api/v1/pluginsGET/api/v1/plugins/{name}POST/api/v1/plugins/{name}/validate

Admin

4 endpoints

Administrative endpoints: config, credentials, users, and audit log.

GET/api/v1/admin/configGET/api/v1/admin/credentialsGET/api/v1/admin/usersGET/api/v1/admin/audit

Agents

3 endpoints

Register and manage remote agents running the discovery pipeline.

POST/api/v1/agents/enrollGET/api/v1/agentsPOST/api/v1/agents/{id}/heartbeat

Chat

2 endpoints

Natural-language chat over the knowledge graph and generated docs.

POST/api/v1/chatGET/api/v1/chat/stream

Metrics

1 endpoint

Prometheus and JSON metrics for the server.

GET/metrics