Get memory health

Returns aggregate health statistics — confidence distribution, contradiction count, staleness, learning velocity.

GET /v1/cognitive/health

Get memory health

cURL

curl --request GET \
  --url http://localhost:8080/v1/cognitive/health \
  --header 'Authorization: Bearer <token>'

200

{
  "overall_score": 123,
  "tier_distribution": {
    "hot": 123,
    "warm": 123,
    "cold": 123,
    "archive": 123
  },
  "contradiction_count": 123,
  "stale_count": 123,
  "learning_velocity": 123
}

Authorizations

Authorization · string · header · required

API key with mk_ or rk_ prefix

Query Parameters

agent_id · string<uuid> · required

Response

200 - application/json

Memory health

overall_score · number<float>

tier_distribution · object

Show child attributes

contradiction_count · integer

stale_count · integer

learning_velocity · number<float>