v2

latestOpenAPI 3.1.02026-08-0382170235.8 KB

cag

Get CAG cache statistics

Get statistics for the CAG cache of a POT.

Returns:

Cache size (constitution, high-certainty, total)
Hit/miss rates
Timing information (initialization, last refresh)

Useful for monitoring cache performance and debugging.

get/pots/{pot_id}/cag/stats

Path parameters

pot_idstring required

POT identifier (UUID or slug)

Response

Cache statistics

pot_idstring required

POT identifier

Example response

{
  "cache_stats": {
    "certainty_size": 47,
    "constitution_size": 5,
    "max_certainty_size": 500,
    "threshold": 0.85,
    "total_size": 52
  },
  "hit_stats": {
    "cache_hits": 142,
    "cache_misses": 8,
    "hit_rate": 0.947,
    "total_searches": 150
  },
  "pot_id": "scipot-core",
  "timing": {
    "initialized_at": "2026-01-20T10:25:00Z",
    "last_refresh": "2026-01-20T11:00:00Z"
  }
}