For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DiscordPlatform
DocumentationIntegrationsAPI referenceSDKsChangelog
DocumentationIntegrationsAPI referenceSDKsChangelog
  • API Reference
      • GETList cached responses
      • POSTList cached responses with filters
      • DELBulk delete cached responses
      • GETRetrieve a cached response
      • GETGet cache summary
      • POSTGet filtered cache summary
      • DELDelete all cached responses
  • Reference
    • Filters API Reference
LogoLogo
DiscordPlatform
API ReferenceCaches

Retrieve a cached response

GET
https://api.respan.ai/api/cache/:id/
GET
/api/cache/:id/
$curl https://api.respan.ai/api/cache/1/ \
>     -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
1{
2  "id": 123,
3  "cache_key": "cached_response_550e8400-e29b-41d4_abc123def456",
4  "prompt_content": "What is the capital of France?",
5  "response_content": "The capital of France is Paris.",
6  "hit_count": 42,
7  "timestamp": "2026-04-10T12:00:00Z",
8  "updated_at": "2026-04-10T12:00:00Z",
9  "request_content": "What is the capital of France?",
10  "prompt_messages": [
11    {
12      "role": "user",
13      "content": "What is the capital of France?"
14    }
15  ],
16  "full_response": {
17    "choices": [
18      {
19        "message": {
20          "role": "assistant",
21          "content": "The capital of France is Paris."
22        }
23      }
24    ]
25  },
26  "response_time": 0.5,
27  "expiry_date": "2026-05-10T12:00:00Z"
28}

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.

Was this page helpful?
Previous

Get cache summary

Next
Built with

Path parameters

idintegerRequired
Numeric cache entry ID returned by the list endpoint.

Headers

AuthorizationstringRequired

Bearer JWT token for dashboard-authenticated cache management endpoints.

Response

Cached response details.
idinteger
Numeric cache entry ID.
cache_keystring
Unique cache key for this cached response.
prompt_contentstring
Prompt text extracted from the cached request.
response_contentstring
Response text extracted from the cached response.
hit_countinteger
Live cache hit count enriched from ClickHouse.
timestampdatetime
When the cache entry was created.
updated_atdatetime
When the cache entry was last updated.
request_contentstring
Stored request text preview. The current backend serializer truncates this field to roughly the first 100 characters.
prompt_messageslist of objects
Original prompt message array stored with the cache entry.
full_responseobject
Full cached provider response object.
response_timedouble
Stored response time for the cached entry, in seconds.
expiry_datedatetime or null

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

Errors

401
Unauthorized Error
404
Not Found Error