Knowledge Tree API v1

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

Query the graph, trigger discovery, generate documentation, manage billing, configure integrations, enforce RBAC, detect anomalies, run simulations, and administer the platform — all over a consistent, JSON-first, JWT-authenticated HTTP API.

Endpoints
370+
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

4 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/meGET/api/v1/auth/roles

Services

5 endpoints

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

GET/api/v1/servicesGET/api/v1/services/{name}GET/api/v1/services/{name}/dependenciesGET/api/v1/services/{name}/impact+1 more

Graph

3 endpoints

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

POST/api/v1/graph/queryGET/api/v1/graph/exportGET/api/v1/graph/topology/{scope}

Discovery

10 endpoints

Manage discovery scopes and runs across all providers.

GET/api/v1/discovery/scopesPOST/api/v1/discovery/scopesGET/api/v1/discovery/scopes/{id}PUT/api/v1/discovery/scopes/{id}+6 more

Docs

5 endpoints

Trigger documentation generation and search generated documents.

GET/api/v1/docsPOST/api/v1/docs/generatePOST/api/v1/docs/searchGET/api/v1/docs/{path}+1 more

Changes

3 endpoints

Infrastructure change feed produced by diffing consecutive runs.

GET/api/v1/changesGET/api/v1/changes/statsPOST/api/v1/changes/violations

Plugins

3 endpoints

Install, enable, configure, and introspect discovery plugins.

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

Admin

15 endpoints

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

GET/api/v1/admin/configPUT/api/v1/admin/configGET/api/v1/admin/statsGET/api/v1/admin/diagnostics+11 more

Agents

7 endpoints

Register and manage remote agents running the discovery pipeline.

POST/api/v1/agents/enrollPOST/api/v1/agents/heartbeatPOST/api/v1/agents/resultsGET/api/v1/agents+3 more

Chat

2 endpoints

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

POST/api/v1/chat/messageGET/api/v1/chat

Metrics

1 endpoint

Prometheus and JSON metrics for the server.

GET/metrics

Assessment

5 endpoints

Cloud posture and cost assessment across discovery scopes.

POST/api/v1/assessment/runGET/api/v1/assessment/runs/{id}GET/api/v1/assessment/scope/{id}/runsGET/api/v1/assessment/scope/{id}/findings+1 more

Search

2 endpoints

Full-text and resource search across the entire knowledge graph.

GET/api/v1/searchGET/api/v1/resources

Cost Intelligence

2 endpoints

Cloud cost intelligence and compliance reporting.

GET/api/v1/cost/intelligenceGET/api/v1/compliance

Onboarding

4 endpoints

Guided onboarding flows for new users and organizations.

GET/api/v1/onboarding/statusPOST/api/v1/onboarding/startPOST/api/v1/onboarding/step/{step}POST/api/v1/onboarding/skip

Notifications

7 endpoints

User notification preferences, in-app notifications, and delivery channels.

GET/api/v1/notificationsPOST/api/v1/notifications/{id}/readPOST/api/v1/notifications/read-allGET/api/v1/notifications/preferences+3 more

Navigation

5 endpoints

Dynamic navigation and search configuration for the frontend UI.

GET/api/v1/navigationGET/api/v1/navigation/recentGET/api/v1/navigation/favoritesPOST/api/v1/navigation/favorites/{id}+1 more

Custom RBAC

8 endpoints

Fine-grained role-based access control with custom roles and permission sets. (Enterprise)

GET/api/v1/rbac/rolesPOST/api/v1/rbac/rolesPUT/api/v1/rbac/roles/{id}DELETE/api/v1/rbac/roles/{id}+4 more

API Keys

4 endpoints

Manage API keys for programmatic access and service accounts.

GET/api/v1/api-keysPOST/api/v1/api-keysDELETE/api/v1/api-keys/{id}POST/api/v1/api-keys/{id}/rotate

Audit

4 endpoints

Immutable audit trail for all API and system actions. (Enterprise)

GET/api/v1/audit/eventsGET/api/v1/audit/events/{id}GET/api/v1/audit/exportGET/api/v1/audit/stats

Backup & Restore

7 endpoints

Automated backup management and point-in-time restore. (Enterprise)

GET/api/v1/backupsPOST/api/v1/backupsGET/api/v1/backups/{id}DELETE/api/v1/backups/{id}+3 more

Dead Letter Queue

6 endpoints

Manage failed event deliveries and retry policies. (Enterprise)

GET/api/v1/dlqGET/api/v1/dlq/{id}POST/api/v1/dlq/{id}/retryPOST/api/v1/dlq/retry-all+2 more

Tenants

6 endpoints

Multi-tenant organization management. (Enterprise)

GET/api/v1/tenantsPOST/api/v1/tenantsGET/api/v1/tenants/{id}PUT/api/v1/tenants/{id}+2 more

Accounts

5 endpoints

User account management, profiles, and team membership.

GET/api/v1/accounts/mePUT/api/v1/accounts/mePOST/api/v1/accounts/inviteGET/api/v1/accounts/team+1 more

Billing

6 endpoints

Stripe-powered subscription management, checkout, invoices, and portal.

POST/api/v1/billing/checkoutPOST/api/v1/billing/portalGET/api/v1/billing/subscriptionGET/api/v1/billing/invoices+2 more

Usage Metering

5 endpoints

Track and report API usage, resource counts, and consumption metrics.

GET/api/v1/usageGET/api/v1/usage/categoriesGET/api/v1/usage/historyGET/api/v1/usage/alerts+1 more

Retention

3 endpoints

Data retention policies for graph snapshots, audit logs, and run history.

GET/api/v1/retentionPUT/api/v1/retention/{scope}POST/api/v1/retention/run

Domains

4 endpoints

Custom domain management for the Knowledge Tree instance. (Enterprise)

GET/api/v1/domainsPOST/api/v1/domainsPOST/api/v1/domains/{id}/verifyDELETE/api/v1/domains/{id}

SLA

4 endpoints

Service Level Agreement tracking and reporting. (Enterprise)

GET/api/v1/slaGET/api/v1/sla/historyGET/api/v1/sla/breachesPUT/api/v1/sla/config

Status Page

7 endpoints

Public and private status page for monitored services.

GET/api/v1/status-pageGET/api/v1/status-page/componentsGET/api/v1/status-page/incidentsPOST/api/v1/status-page/incidents+3 more

Integration Registry

6 endpoints

Central registry for all third-party integrations. (Enterprise)

GET/api/v1/integrationsGET/api/v1/integrations/{type}PUT/api/v1/integrations/{type}POST/api/v1/integrations/{type}/test+2 more

ServiceNow

4 endpoints

ServiceNow CMDB synchronization and incident integration. (Enterprise)

POST/api/v1/integrations/servicenow/syncGET/api/v1/integrations/servicenow/sync/statusPOST/api/v1/integrations/servicenow/incidentGET/api/v1/integrations/servicenow/ci/{sys_id}

PagerDuty

5 endpoints

PagerDuty alerting and on-call integration. (Enterprise)

POST/api/v1/integrations/pagerduty/alertPOST/api/v1/integrations/pagerduty/alert/{id}/acknowledgePOST/api/v1/integrations/pagerduty/alert/{id}/resolveGET/api/v1/integrations/pagerduty/oncall+1 more

Slack

4 endpoints

Slack messaging, notifications, and slash commands. (Enterprise)

POST/api/v1/integrations/slack/messageGET/api/v1/integrations/slack/channelsPOST/api/v1/integrations/slack/eventsPOST/api/v1/integrations/slack/sync

Jira

4 endpoints

Jira issue tracking and project integration. (Enterprise)

POST/api/v1/integrations/jira/issuePOST/api/v1/integrations/jira/linkGET/api/v1/integrations/jira/issuesPOST/api/v1/integrations/jira/sync

Confluence

3 endpoints

Confluence documentation publishing integration. (Enterprise)

POST/api/v1/integrations/confluence/publishGET/api/v1/integrations/confluence/spacesPOST/api/v1/integrations/confluence/sync

Terraform

4 endpoints

Terraform state file ingestion and drift detection. (Enterprise)

POST/api/v1/integrations/terraform/statePOST/api/v1/integrations/terraform/driftGET/api/v1/integrations/terraform/workspacesGET/api/v1/integrations/terraform/drift/{id}

GitHub

5 endpoints

GitHub integration for infrastructure-as-code repositories and issues. (Enterprise)

GET/api/v1/integrations/github/reposPOST/api/v1/integrations/github/repos/{owner}/{repo}/ingestPOST/api/v1/integrations/github/issuesPOST/api/v1/integrations/github/webhooks+1 more

GitLab

3 endpoints

GitLab integration for IaC repos, issues, and CI pipelines. (Enterprise)

GET/api/v1/integrations/gitlab/projectsPOST/api/v1/integrations/gitlab/projects/{id}/ingestPOST/api/v1/integrations/gitlab/issues

Grafana

4 endpoints

Grafana dashboard and alert integration. (Enterprise)

GET/api/v1/integrations/grafana/dashboardsPOST/api/v1/integrations/grafana/dashboardsPOST/api/v1/integrations/grafana/annotationsGET/api/v1/integrations/grafana/alerts

Datadog

4 endpoints

Datadog monitor, metric, and event integration. (Enterprise)

GET/api/v1/integrations/datadog/metricsPOST/api/v1/integrations/datadog/eventsGET/api/v1/integrations/datadog/monitorsPOST/api/v1/integrations/datadog/sync

Open Policy Agent

4 endpoints

OPA policy evaluation and compliance enforcement. (Enterprise)

POST/api/v1/integrations/opa/evaluateGET/api/v1/integrations/opa/policiesPOST/api/v1/integrations/opa/policiesDELETE/api/v1/integrations/opa/policies/{name}

Backstage

2 endpoints

Backstage Entity Provider API and catalog integration. (Enterprise)

GET/backstage/entitiesPOST/api/v1/integrations/backstage/sync

Plugin Registry

5 endpoints

Central registry for publishing and discovering plugins. (Enterprise)

GET/api/v1/registry/pluginsGET/api/v1/registry/plugins/{name}POST/api/v1/registry/pluginsDELETE/api/v1/registry/plugins/{name}/{version}+1 more

Plugin Signing

4 endpoints

Cryptographic signing and verification of plugins. (Enterprise)

POST/api/v1/registry/signing/signPOST/api/v1/registry/signing/verifyGET/api/v1/registry/signing/public-keyPOST/api/v1/registry/signing/rotate

Marketplace

5 endpoints

Plugin marketplace for browsing, purchasing, and managing add-ons. (Enterprise)

GET/api/v1/marketplace/itemsGET/api/v1/marketplace/items/{id}POST/api/v1/marketplace/items/{id}/purchaseGET/api/v1/marketplace/purchases+1 more

Plugin Sandbox

5 endpoints

Isolated execution environment for community and untrusted plugins. (Enterprise)

GET/api/v1/plugins/sandboxPOST/api/v1/plugins/sandboxGET/api/v1/plugins/sandbox/{id}POST/api/v1/plugins/sandbox/{id}/stop+1 more

Plugin Analytics

4 endpoints

Usage analytics and performance metrics for installed plugins. (Enterprise)

GET/api/v1/plugins/analyticsGET/api/v1/plugins/analytics/{name}GET/api/v1/plugins/analytics/errorsGET/api/v1/plugins/analytics/execution-times

Plugin Reviews

5 endpoints

Community ratings and reviews for registry plugins. (Enterprise)

GET/api/v1/registry/plugins/{name}/reviewsPOST/api/v1/registry/plugins/{name}/reviewsPUT/api/v1/registry/plugins/{name}/reviews/{id}DELETE/api/v1/registry/plugins/{name}/reviews/{id}+1 more

Anomaly Detection

6 endpoints

ML-based detection of infrastructure anomalies and unusual patterns. (Enterprise)

GET/api/v1/anomaliesGET/api/v1/anomalies/{id}POST/api/v1/anomalies/{id}/acknowledgePOST/api/v1/anomalies/{id}/resolve+2 more

Impact Analysis

4 endpoints

Impact and blast-radius analysis using graph topology. (Enterprise)

GET/api/v1/impact/resources/{id}POST/api/v1/impact/changeGET/api/v1/impact/reports/{id}GET/api/v1/impact/reports

Auto-Remediation

6 endpoints

Automated remediation runbooks and self-healing workflows. (Enterprise)

GET/api/v1/remediation/rulesPOST/api/v1/remediation/rulesPUT/api/v1/remediation/rules/{id}DELETE/api/v1/remediation/rules/{id}+2 more

NL Queries

4 endpoints

Natural language query interface for infrastructure data. (Enterprise)

POST/api/v1/nl/queryGET/api/v1/nl/suggestionsPOST/api/v1/nl/explainGET/api/v1/nl/history

Compliance Reports

6 endpoints

Generate and manage compliance reports for SOC 2, ISO 27001, HIPAA, etc. (Enterprise)

GET/api/v1/compliance/frameworksPOST/api/v1/compliance/reportsGET/api/v1/compliance/reportsGET/api/v1/compliance/reports/{id}+2 more

Capacity Forecasting

4 endpoints

Resource capacity trend analysis and forecasting. (Enterprise)

GET/api/v1/capacity/forecastGET/api/v1/capacity/trendsGET/api/v1/capacity/recommendationsPOST/api/v1/capacity/what-if

Security Trends

6 endpoints

Security posture trends, vulnerability tracking, and remediation tracking. (Enterprise)

GET/api/v1/security/overviewGET/api/v1/security/findingsGET/api/v1/security/findings/{id}GET/api/v1/security/trends+2 more

Incident Response

8 endpoints

Incident management, timeline tracking, and post-mortems. (Enterprise)

GET/api/v1/incidentsPOST/api/v1/incidentsGET/api/v1/incidents/{id}PUT/api/v1/incidents/{id}+4 more

Webhook Events

6 endpoints

Webhook configuration, event delivery, and logging. (Enterprise)

GET/api/v1/webhooksPOST/api/v1/webhooksDELETE/api/v1/webhooks/{id}GET/api/v1/webhooks/deliveries+2 more

Dashboards

6 endpoints

Custom dashboards for visualising infrastructure data. (Enterprise)

GET/api/v1/dashboardsPOST/api/v1/dashboardsGET/api/v1/dashboards/{id}PUT/api/v1/dashboards/{id}+2 more

Data Lake Export

5 endpoints

Export graph data to external data lakes and warehouses. (Enterprise)

GET/api/v1/data-lake/configsPOST/api/v1/data-lake/configsPOST/api/v1/data-lake/configs/{id}/exportGET/api/v1/data-lake/exports+1 more

Infrastructure Scoring

4 endpoints

Overall health, reliability, and security scoring for infrastructure. (Enterprise)

GET/api/v1/scoring/overviewGET/api/v1/scoring/categoriesGET/api/v1/scoring/historyGET/api/v1/scoring/improvements

Cross-Account

4 endpoints

Cross-account resource aggregation and unified views. (Enterprise)

GET/api/v1/cross-account/linksPOST/api/v1/cross-account/linksDELETE/api/v1/cross-account/links/{id}POST/api/v1/cross-account/links/{id}/test

Cost Optimization

6 endpoints

Cloud cost analysis, savings recommendations, and budget tracking. (Enterprise)

GET/api/v1/cost-optimization/overviewGET/api/v1/cost-optimization/recommendationsGET/api/v1/cost-optimization/savings-plannerGET/api/v1/cost-optimization/budgets+2 more

Certificate Tracking

5 endpoints

SSL/TLS certificate lifecycle management and expiry monitoring. (Enterprise)

GET/api/v1/certificatesGET/api/v1/certificates/{id}POST/api/v1/certificatesPOST/api/v1/certificates/check-expiry+1 more

Multi-Account

5 endpoints

Multi-cloud multi-account resource aggregation. (Enterprise)

GET/api/v1/multi-account/overviewGET/api/v1/multi-account/accountsPOST/api/v1/multi-account/accountsDELETE/api/v1/multi-account/accounts/{id}+1 more

Time Machine

5 endpoints

Point-in-time graph snapshots and historical exploration. (Enterprise)

GET/api/v1/time-machine/snapshotsGET/api/v1/time-machine/snapshots/{id}POST/api/v1/time-machine/comparePOST/api/v1/time-machine/snapshots+1 more

Architecture Diagrams

5 endpoints

Auto-generated architecture diagrams from the knowledge graph. (Enterprise)

GET/api/v1/diagramsPOST/api/v1/diagramsGET/api/v1/diagrams/{id}GET/api/v1/diagrams/{id}/export+1 more

Dependency Walker

4 endpoints

Deep dependency graph traversal and analysis. (Enterprise)

GET/api/v1/dependencies/walk/{resource_id}GET/api/v1/dependencies/pathGET/api/v1/dependencies/critical-pathGET/api/v1/dependencies/circular

Simulator

6 endpoints

What-if simulation engine for infrastructure changes. (Enterprise)

POST/api/v1/simulator/scenariosGET/api/v1/simulator/scenariosGET/api/v1/simulator/scenarios/{id}POST/api/v1/simulator/scenarios/{id}/run+2 more

Health Score

6 endpoints

Aggregated health scores for services, resources, and infrastructure. (Enterprise)

GET/api/v1/health-score/{resource_id}GET/api/v1/health-score/services/{name}GET/api/v1/health-score/overviewGET/api/v1/health-score/history+2 more

Post-Incident Review

7 endpoints

Post-incident review reports with timeline, analysis, and action items. (Enterprise)

GET/api/v1/pirPOST/api/v1/pirGET/api/v1/pir/{id}PUT/api/v1/pir/{id}+3 more

Persona Views

6 endpoints

Role-based views and filtered perspectives for different personas. (Enterprise)

GET/api/v1/personasPOST/api/v1/personasGET/api/v1/personas/{id}PUT/api/v1/personas/{id}+2 more

Airgap

6 endpoints

Air-gapped deployment management and offline operation. (Enterprise)

GET/api/v1/airgap/statusGET/api/v1/airgap/bundlesPOST/api/v1/airgap/bundlesPOST/api/v1/airgap/bundles/{id}/apply+2 more

SSO

2 endpoints

Single sign-on configuration and authentication flows. (Enterprise)

GET/api/v1/auth/sso/loginGET/api/v1/auth/sso/callback

Stats

1 endpoint

Aggregated platform statistics.

GET/api/v1/stats

Settings

2 endpoints

User and account settings management.

GET/api/v1/settingsPUT/api/v1/settings

License

1 endpoint

License key management for enterprise features.

GET/license