Skip to Content
API ReferenceOpenAPI SpecsKnowledge Graph Service

Knowledge Graph Service — OpenAPI

The knowledge graph service manages the Apache AGE graph, entity CRUD, and context assembly.

Accessing the Spec

Swagger UIhttp://localhost:8003/docs 
ReDochttp://localhost:8003/redoc 
OpenAPI JSONhttp://localhost:8003/openapi.json 

These URLs access the service directly (port 8003), bypassing the API gateway. In production, use the gateway at port 8000.

Route Prefixes

  • /entities — Graph entity CRUD (20 vertex labels)
  • /edges — Relationship management (16 edge labels)
  • /query — Whitelisted graph-query templates ({template_id, params}, tenant-scoped, injection-safe); legacy raw {query, columns} Cypher still accepted but deprecated (removal is R35)
  • /context — Context assembly for agents (well API and managed entity)
  • /impact — Bidirectional, outward, inward impact analysis and infrastructure tree
  • /admin — Entity type management, relationship rules, field schemas, RRC mappings, event detection rules
  • /public — Read-only entity type and relationship schemas
  • /seed — Demo data seeding

Explore the Swagger UI for full schemas including CreateEntityResponse, CypherQueryResponse, ContextAssemblyResponse, ImpactAnalysisResponse, and InfrastructureTreeResponse.

Last updated on