Database Health Check

get/v1/graphs/{graph_id}/health

Authentication

Authenticate in any one of these ways — not all of them:

API key in the X-API-Key header.
Bearer token in the Authorization header.

Path parameters

Name	Type	Description
`graph_id`required	string	Graph Id

Example request

curl

curl -X GET "https://api.robosystems.ai/v1/graphs/{graph_id}/health" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY"

Responses

200 Successful Response

Field	Type	Description
`graph_id`required	string	Graph database identifier
`status`required	string	Overall health status
`connection_status`required	string	Database connection status
`uptime_seconds`required	number	Database uptime in seconds
`last_query_time`optional	string	Timestamp of last query execution
`query_count_24h`required	integer	Number of queries executed in last 24 hours
`avg_query_time_ms`required	number	Average query execution time in milliseconds
`error_rate_24h`required	number	Error rate in last 24 hours (percentage)
`memory_usage_mb`optional	number	Instance memory in use, MB. Only populated for dedicated single-tenant instances; null on shared repositories and packed tiers.
`memory_usage_percent`optional	number	Instance memory in use, percent. Expect high values during materialization — the engine deliberately boosts to near the whole instance while rebuilding. Read `resource_status` rather than this number alone. Dedicated instances only.
`cpu_usage_percent`optional	number	Instance CPU in use, percent. Dedicated single-tenant instances only.
`resource_status`optional	string	Interpreted instance load: 'idle' (headroom), 'busy' (working normally — typical while materializing), 'constrained' (sustained pressure worth acting on). Null when resource metrics are not exposed.
`storage_usage_mb`optional	number	Storage usage in MB
`alerts`optional	string[]	Active alerts or warnings
`is_stale`optional	boolean	Whether the graph has staged changes not yet materialized Default: `false`
`stale_reason`optional	string	Reason the graph was marked stale (e.g. 'file_deleted: data.parquet')
`stale_since`optional	string	ISO timestamp when the graph became stale
`last_materialized_at`optional	string	ISO timestamp of the last successful materialization
`hours_since_materialization`optional	number	Hours elapsed since last materialization

Status	Meaning
400	Invalid request
401	Authentication required
403	Access denied
404	Resource not found
422	Validation Error
429	Rate limit exceeded
500	Internal server error