Caches

Get cache summary

Changed on

Returns the number of unexpired cached responses matching the filters.

post/api/caches/summary/

Request

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

Request body

filtersobject

Each key is a field to filter on, and each value is a condition: {"<field>": {"operator": "<operator>", "value": [...]}}. A cached response must match every condition. To set two conditions on one field, such as a range, pass a list of conditions.

Operators: "" (equals, the default), not, in, not_in, lt, lte, gt, gte, contains, not_contains, icontains (ignores case), startswith, not_startswith, endswith, not_endswith, empty, not_empty. Put values in a list: "" and in match any of the listed values, and not and not_in match none of them. Other operators take one value; for empty and not_empty, send [""].

Fields: cache_key_by_org_uuid (the cache_key value the API returns), timestamp (when the response was cached), updated_at, and expiry_date. Send dates as ISO 8601 strings. Unsupported fields return a 400 error.

Example:

{
  "timestamp": {"operator": "gte", "value": ["2026-09-01T00:00:00Z"]}
}

Example request

{
  "filters": {
    "cache_key_by_org_uuid": {
      "operator": "",
      "value": [
        "cached_response_550e8400"
      ]
    }
  }
}

Response

Filtered cache summary statistics.

total_countinteger required

Total number of cached responses that match the query.

Example response

{
  "total_count": 25
}

Changes

    • info

      api operation id caches_getFilteredCachedResponsesSummary removed and replaced with getFilteredCachedResponsesSummary

    • info

      the endpoint scheme security DashboardJwt was added to the API

    • info

      api tag Caches added

    • info

      api tag caches removed

    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status