API ReferenceCaches

Bulk delete cached responses

Bulk delete cached responses. Provide exactly one of cache_keys, ids, or all. ids uses internal integer IDs and is JWT-only; API-key clients should use cache_keys or all.

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

OR
AuthorizationBearer

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

Request

This endpoint expects any.
anyRequired
OR
anyRequired
OR
anyRequired

Response

Bulk delete result.
success_countinteger
Number of cache entries successfully deleted.
deleted_countinteger
Number of cache entries deleted.
messagestring

Human-readable result message.

Errors

400
Bad Request Error
401
Unauthorized Error