4e064cf81dae

latestOpenAPI 3.1.02026-08-131831,331960.0 KB

caches

Get filtered cache summary

Return the total number of cached responses after applying filters. This endpoint supports both JWT and API key authentication.

post/api/caches/summary/

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Request body

filtersApiCachesSummaryPostRequestBodyContentApplicationJsonSchemaFilters

Filter criteria using the standard Respan filter format.

Response

Filtered cache summary statistics.

total_countinteger required

Total number of cached responses that match the query.