KEkeywordsai
Caches

Delete cached responses in bulk

Changed on

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/

Request

  • Base URL
    https://api.respan.ai
  • URL
    https://api.respan.ai/api/caches/bulk/
  • Auth
    • HTTP bearer
    • or HTTP bearer

Request body

cache_keysstring[]

Cache keys to delete. Supported for API key and JWT authentication.

idsinteger[]

Internal numeric cache entry IDs to delete. JWT only.

allboolean

Set to true to delete all cached responses for the current organization. The server rejects false.

Example request

{
  "cache_keys": [
    "cached_response_550e8400"
  ],
  "ids": [
    123,
    124,
    125
  ],
  "all": true
}

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.

Example response

{
  "success_count": 1,
  "error_count": 0,
  "errors": []
}

Changes

  • c30bcb383ee8Revision changes
    • breaking

      request body became required

    • breaking

      the request property's minItems was increased to 1

    • breaking

      the request property's minItems was increased to 1

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      api operation id caches_bulkDeleteCachedResponses removed and replaced with bulkDeleteCachedResponses

    • info

      the endpoint scheme security DashboardJwt was added to the API

    • info

      api tag Caches added

    • info

      api tag caches removed

    • info

      added subschema #2 to the response body allOf list for the response status

  • b830b79cfd52Revision changes
    • breaking

      the response's body type changed from no type to object for status

    • info

      removed the non-success response with the status

    • info

      added the required property to the response with the status