4e064cf81dae
latestOpenAPI 3.1.02026-08-131831,331960.0 KBdashboard
List cache hit metrics
Returns semantic cache hit metrics (count, tokens, savings, hit %) as a time series.
post/api/dashboard/cache-hit-metrics/
Query parameters
summary_type'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly' | 'last_24h' | 'all'
Preset time range. Use this or explicit start_time / end_time.
datestring date
Base date used with summary_type presets.
start_timestring date-time
Optional explicit ISO start time.
end_timestring date-time
Optional explicit ISO end time.
time_tick'minute' | 'hour' | 'day'
Bucket granularity for time-series responses.
timezone_offsetnumber double
Timezone offset, in hours, used when resolving preset ranges.
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.
Response
Successful response.