Suggested Memories
curl --request GET \
--url https://api.memoclaw.com/v1/suggestedimport requests
url = "https://api.memoclaw.com/v1/suggested"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.memoclaw.com/v1/suggested', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.memoclaw.com/v1/suggested",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.memoclaw.com/v1/suggested"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.memoclaw.com/v1/suggested")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.memoclaw.com/v1/suggested")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"suggested": [
{}
],
"categories": {},
"total": 123
}API Reference
Suggested Memories
GET /v1/suggested — Get proactive memory suggestions for review.
GET
/
v1
/
suggested
Suggested Memories
curl --request GET \
--url https://api.memoclaw.com/v1/suggestedimport requests
url = "https://api.memoclaw.com/v1/suggested"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.memoclaw.com/v1/suggested', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.memoclaw.com/v1/suggested",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.memoclaw.com/v1/suggested"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.memoclaw.com/v1/suggested")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.memoclaw.com/v1/suggested")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"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
| Category | Description |
|---|---|
stale | High importance but not recently accessed — might need refresh |
fresh | Recently stored but never accessed — verify they’re useful |
hot | Frequently accessed — your most valuable memories |
decaying | Approaching decay threshold — access soon or they’ll fade |
Query Parameters
number
Max memories to return. Default:
10, max: 50.string
Filter to a specific category:
stale, fresh, hot, or decaying.string
Filter by namespace.
string
Filter by session ID.
string
Filter by agent ID.
Response
array
Array of suggested memories with category labels.
object
Breakdown of counts per category.
number
Total suggestions available.
Example
curl "https://api.memoclaw.com/v1/suggested?limit=5&category=stale"
const response = await fetch(
"https://api.memoclaw.com/v1/suggested?limit=5&category=stale"
);
const data = await response.json();
from memoclaw import MemoClaw
client = MemoClaw()
result = client.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.