Sign in

4e064cf81dae

latestOpenAPI 3.1.02026-08-131831,331960.0 KB
caches

Retrieve a cached response

Retrieve a cached response by its organization-scoped cache key. API-key responses omit internal numeric IDs.

get/api/caches/{cache_key}/

Path parameters

cache_keystring required

Organization-scoped cache key returned by the cache list endpoint.

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

Cached response details.

idinteger

Internal numeric ID. Present only for dashboard-JWT responses.

cache_keystring required

Organization-scoped public cache key.

prompt_contentstring required

Prompt text extracted from the cached request.

response_contentstring required

Response text extracted from the cached response.

request_contentstring

Stored request text preview. The current backend serializer truncates this field to roughly the first 100 characters.

prompt_messagesApiCachesCacheKeyGetResponsesContentApplicationJsonSchemaPromptMessagesItems[]

Original prompt message array stored with the cache entry.

full_responseApiCachesCacheKeyGetResponsesContentApplicationJsonSchemaFullResponse

Full cached provider response object.

hit_countinteger required

Live cache hit count enriched from ClickHouse.

response_timenumber double

Stored response time for the cached entry, in seconds.

timestampstring date-time required

When the cache entry was created.

updated_atstring date-time required

When the cache entry was last updated.

expiry_datestring date-time nullable

When the cache entry expires. null means no expiry date is set.