---
title: "Pre-load CAG cache"
method: POST
path: "/pots/{pot_id}/cag/warm"
tags: ["cag", "cag"]
---

# Pre-load CAG cache

`POST /pots/{pot_id}/cag/warm`

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

## Path parameters

- `pot_id` string, required — POT identifier (UUID or slug)

## Response `200`

Cache warmed (or already warm)

- CAGWarmResponse — Response for POST /cag/warm endpoint.
  - `status` 'warmed' | 'already_warm', required — Warm operation result
  - `cache_stats` WarmCacheStats, required — Cache stats for warm response.
    - `constitution_size` integer, required
    - `certainty_size` integer, required
    - `total_size` integer, required
    - `initialized_at` string, nullable

## Other responses

- `404` — POT not found
- `422` — Validation Error
- `500` — Cache initialization failed

---

[API](https://skmtc.dev/scipot/apis/scipot-core-api.md) · [All operations](https://skmtc.dev/scipot/apis/scipot-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scipot/scipot-core-api/revisions/e8712e9ffeae/schema)