Skip to main content
GET
/
v1
/
suggested
Suggested Memories
curl --request GET \
  --url https://api.memoclaw.com/v1/suggested
{
  "suggested": [
    {}
  ],
  "categories": {},
  "total": 123
}
Price: FREE Suggested returns memories you should be reviewing based on access patterns and importance. Use this for proactive memory maintenance instead of only recalling on-demand.

​
Categories

CategoryDescription
staleHigh importance but not recently accessed — might need refresh
freshRecently stored but never accessed — verify they’re useful
hotFrequently accessed — your most valuable memories
decayingApproaching decay threshold — access soon or they’ll fade

​
Query Parameters

​
limit
number
Max memories to return. Default: 10, max: 50.
​
category
string
Filter to a specific category: stale, fresh, hot, or decaying.
​
namespace
string
Filter by namespace.
​
session_id
string
Filter by session ID.
​
agent_id
string
Filter by agent ID.

​
Response

​
suggested
array
Array of suggested memories with category labels.
​
categories
object
Breakdown of counts per category.
​
total
number
Total suggestions available.

​
Example

curl "https://api.memoclaw.com/v1/suggested?limit=5&category=stale"
Response
{
  "suggested": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "content": "User's API key for production is stored in 1Password",
      "metadata": { "tags": ["secrets"] },
      "importance": 0.9,
      "memory_type": "preference",
      "namespace": "default",
      "session_id": null,
      "agent_id": null,
      "created_at": "2024-01-01T08:00:00Z",
      "accessed_at": "2024-01-15T10:30:00Z",
      "access_count": 5,
      "relation_count": 2,
      "category": "stale",
      "review_score": 1.35
    }
  ],
  "categories": {
    "stale": 12,
    "fresh": 5,
    "hot": 8,
    "decaying": 3
  },
  "total": 28
}
Run /v1/suggested periodically (e.g., daily) to maintain memory health. Accessing a memory resets its decay timer.