API referencePrivate cache
Get private cache stats
Records (entities and exact responses), bytes, hits and the vendor spend cache hits saved this month and all time, plus daily hit/partial/miss counts. Cache hits are always free.
Authorization
bearer AuthorizationBearer <token>
In: header
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/cache/stats"{ "object": "cache_stats", "records": 0, "entities": 0, "responses": 0, "limit": 0, "bytes": 0, "hits": 0, "saved_micro_month": 0, "saved_micro_total": 0, "month": "string", "by_capability": [ { "capability": "string", "records": 0, "hits": 0, "saved_micro": 0 } ], "daily": [ { "day": "2019-08-24", "hit": 0, "partial": 0, "stale": 0, "miss": 0, "saved_micro": 0 } ]}Purge the private cache DELETE
Delete cached records by `key`, `tag` or `capability`, or everything with `all=true` (crypto-shreds the workspace cache key: nothing sealed before can be read again).
Look up a call GET
Cost, timings (total, upstream, overhead, TTFB, queue), provider, outcome and every routed attempt of one call, like OpenRouter's generation lookup. Keys without logs:read only see calls they made. Available a few seconds after the call.