- Graphwise Platform Documentation
- Graphwise API Endpoints
- GraphRAG
- Conversations Service API
- The Conversations Service API - Health & Monitoring
The Conversations Service API - Health & Monitoring
02/06/2026
Health check APIs provide endpoints that expose the operational status of the conversation service and its dependencies allowing you to monitor these and ensure that they are up and running.
Returns troubleshooting information to debug issues.
GET /conversations/__trouble
curl https://api.example.com/conversations/__trouble
Returns detailed health status with dependency checks.
GET /conversations/__health
curl https://api.example.com/conversations/__health
{
"status": "OK",
"healthChecks": [
{
"status": "OK",
"severity": "HIGH",
"name": "DuckDB Healthcheck",
"type": "duckdb",
"impact": "GraphRAG conversation data cannot be read or written",
"message": "DuckDB is healthy"
},
{
"status": "OK",
"severity": "HIGH",
"name": "Keycloak Healthcheck",
"type": "keycloak",
"impact": "User authentication and authorization will fail",
"message": "Keycloak is reachable and status is UP"
},
{
"status": "OK",
"severity": "HIGH",
"name": "n8n Healthcheck",
"type": "n8n",
"impact": "GraphRAG won't be able to process chat questions",
"message": "n8n is healthy"
}
]
}Dependency | Impact if Failed |
|---|---|
DuckDB | Cannot read/write conversation data |
Keycloak | Authentication will fail |
n8n | Cannot process chat questions |
Quick binary health check for load balancers.
GET /conversations/__gtg
curl https://api.example.com/conversations/__gtg
{"gtg":"OK"}{"gtg":"UNAVAILABLE"}Returns service metadata and version information.
GET /conversations/__about
{
"description": "GraphRAG Conversation API, backend for the GraphRAG application.",
"version": "1.2.0",
"versionInfo": {
"jdkVersion": "21"
},
"additionalInfo": {
"Implementation-Title": "graphrag-conversation",
"Spring-Boot-Version": "3.5.6"
}
}In this section: