Endpoint Cache Stats
Snapshot of the response-cache state for an endpoint. The platform's edge cache is opt-in via a traffic policy with caching rules — only endpoints that have been instructed to cache will have meaningful entries here.
The numbers reflect what's currently held in the platform's Redis cache cluster. They drift naturally as TTLs expire and as the LRU evictor runs; treat them as a snapshot, not a counter.
Path parameters
id string (uuid) Req
Endpoint UUID.
Response (200 OK)
configured boolean
false on deployments where Redis isn't wired up for response caching at all (the rest of the fields are zero in that case). true means the cache backend is reachable; the endpoint may still have zero entries if no caching policy is active.entries int
Number of cached response objects currently held for this endpoint.
Errors
401 Unauthorized
Missing auth.
403 Forbidden
Endpoint doesn't exist or belongs to another user (handler returns 403, not 404, on this path).
Request
curl "https://api.ngris.com/v1/endpoints/<uuid>/cache/stats" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
stats = client._get_raw("/endpoints/<endpoint_uuid>/cache/stats")
print(f"{stats['entries']} cached responses")
Response — cache configured
{
"configured": true,
"entries": 1234
}
Response — cache disabled
{
"configured": false,
"entries": 0
}