v2

latestOpenAPI 3.1.02026-08-0382170235.8 KB
cag
cag

Pre-load CAG cache

Explicitly warm up the CAG cache for a POT.

This loads:

  • All Constitution facts (Layer 1)
  • Facts with POT Score >= threshold (Layer 2)

Useful for:

  • Pre-loading cache before expected queries
  • Ensuring cache is ready for low-latency responses
  • Verifying cache initialization works correctly
post/pots/{pot_id}/cag/warm

Path parameters

pot_idstring required

POT identifier (UUID or slug)

POT identifier (UUID or slug)

Response

Cache warmed (or already warm)

status'warmed' | 'already_warm' required

Warm operation result

Example response

{
  "cache_stats": {
    "certainty_size": 47,
    "constitution_size": 5,
    "initialized_at": "2026-01-20T10:30:00Z",
    "total_size": 52
  },
  "status": "warmed"
}