Sign in
caches

Retrieve a cached response

Retrieve a single cached response by numeric cache entry ID. The current backend route is /api/cache/{id}/; there is no public lookup route by cache_key. This cache management endpoint currently requires dashboard JWT authentication.

get/api/cache/{id}/

Path parameters

idinteger required

Numeric cache entry ID returned by the list endpoint.

Headers

Authorizationstring required

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Response

Cached response details.

idinteger required

Numeric cache entry ID.

cache_keystring required

Unique cache key for this cached response.

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_messagesApiCacheIdGetResponsesContentApplicationJsonSchemaPromptMessagesItems[]

Original prompt message array stored with the cache entry.

full_responseApiCacheIdGetResponsesContentApplicationJsonSchemaFullResponse

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.

Changes