API Reference
Stats
GET /api/v1/memories/stats — aggregate counts (PR
The caura_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)
Authorization
APIKeyHeader X-API-Key<token>
In: header
Query Parameters
tenant_id?string|null
fleet_id?string|null
agent_id?string|null
scope?|
Opt-in aggregate scope, mirroring the MCP/plugin contract. 'agent' = your own memories (trust >= 1); 'fleet' = cross-agent within a fleet (own fleet trust >= 1, a different fleet trust >= 2); 'all' = tenant-wide (trust >= 2). Omit for the historical behaviour.
memory_type?string|null
status?string|null
include_deleted?Include Deleted
Default
falseResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://loading/api/v1/memories/stats"null{
"detail": "string",
"error": {
"code": "string",
"message": "string",
"details": {}
}
}{
"detail": "string",
"error": {
"code": "string",
"message": "string",
"details": {}
}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}Public stats
A lightweight unauthenticated counters endpoint used by the marketing-site status bar.
Response Body
application/json
application/json
application/json
curl -X GET "https://loading/api/v1/stats"{
"property1": 0,
"property2": 0
}{
"detail": "string",
"error": {
"code": "string",
"message": "string",
"details": {}
}
}{
"detail": "string",
"error": {
"code": "string",
"message": "string",
"details": {}
}
}