Sign in
caches

Bulk delete cached responses

Delete cached responses using exactly one selector: cache_keys, ids, or all: true. Up to 1,000 keys or IDs can be deleted per request. ids uses internal integer IDs and is JWT-only; API-key clients should use cache_keys or all. Rate limit: 60 requests per minute per organization for API-key calls (shared across API keys) and per user for JWT calls.

delete/api/caches/bulk/

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, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Request body

{"stackTrail":"components:schemas:Caches_bulkDeleteCachedResponses_Request:oneOf:0","oasType":"schema","type":"unknown","description":"Any type"}
OR
{"stackTrail":"components:schemas:Caches_bulkDeleteCachedResponses_Request:oneOf:1","oasType":"schema","type":"unknown","description":"Any type"}
OR
{"stackTrail":"components:schemas:Caches_bulkDeleteCachedResponses_Request:oneOf:2","oasType":"schema","type":"unknown","description":"Any type"}

Response

Cached responses were deleted synchronously.

success_countinteger required

Number of items successfully processed.

error_countinteger required

Number of items that failed.

deleted_countinteger required

Number of resources matched and processed for deletion.

messagestring required

Human-readable deletion result.

Changes