Skip to main content

​
Endpoint

GET /v1/memory/expiring

​
Query Parameters

ParameterTypeDescription
withinstringTime window (e.g. 1h, 6h, 24h, 7d). Default: 24h
typestringFilter by memory type

​
Response (200)

{
  "expiring": [
    {
      "id": "...",
      "type": "working",
      "key": "facts/temp-data",
      "version": 1,
      "sizeBytes": 128,
      "expiresAt": "2026-03-23T21:00:00.000Z",
      "hoursLeft": 5.2,
      "metadata": { "tags": ["temp"] },
      "createdAt": "2026-03-20T09:00:00Z"
    }
  ],
  "count": 5,
  "within": "24h"
}
Poll this endpoint periodically and use TTL Alerts to renew important memories before they expire.