Update a cached response

{
  "cache_key": "cached_response_550e8400-e29b-41d4_abc123def456",
  "prompt_content": "What is the capital of France?",
  "response_content": "The capital of France is Paris.",
  "hit_count": 42,
  "timestamp": "2026-04-10T12:00:00Z",
  "updated_at": "2026-04-10T12:00:00Z",
  "id": 123,
  "request_content": "What is the capital of France?",
  "prompt_messages": [
    {
      "role": "user",
      "content": "What is the capital of France?"
    }
  ],
  "full_response": {
    "choices": [
      {
        "message": {
          "role": "assistant",
          "content": "The capital of France is Paris."
        }
      }
    ]
  },
  "response_time": 0.5,
  "expiry_date": "2026-05-10T12:00:00Z"
}

Update the expiry date of a cached response identified by its public cache key.

Authentication

AuthorizationBearer

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.

AuthorizationBearer

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

Path parameters

cache_keystringRequired

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

Request

This endpoint expects an object.

expiry_datedatetime or nullOptional

New expiry time; null clears it.

Response

Updated cached response.

cache_keystring

Organization-scoped public cache key.

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.

idintegerOptional

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

request_contentstringOptional

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

prompt_messageslist of objectsOptional

Original prompt message array stored with the cache entry.

full_responseobjectOptional

Full cached provider response object.

response_timedoubleOptional

Stored response time for the cached entry, in seconds.

expiry_datedatetime or nullOptional

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

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

$	curl -X PATCH https://api.respan.ai/api/caches/cache_key/ \
>	-H "Authorization: Bearer <respanApiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{}'