MemClaw / docs
API Reference

Stats

GET /api/v1/memories/stats — aggregate counts (PR

The memclaw_stats MCP tool added in PR #64 calls compute_memory_stats(), which is shared with the REST handler below. Both surfaces return {total, by_type, by_agent, by_status, scope} (REST omits scope).

Memory stats (auth)

GET
/api/v1/memories/stats

Authorization

APIKeyHeader
X-API-Key<token>

In: header

Query Parameters

tenant_id?string|null
fleet_id?string|null
agent_id?string|null
memory_type?string|null
status?string|null
include_deleted?Include Deleted
Defaultfalse

Response Body

application/json

application/json

curl -X GET "https://loading/api/v1/memories/stats"
null
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Public stats

A lightweight unauthenticated counters endpoint used by the marketing-site status bar.

GET
/api/v1/stats

Response Body

application/json

curl -X GET "https://loading/api/v1/stats"
{
  "property1": 0,
  "property2": 0
}