curl -X POST "https://api.memanto.ai/agents/my-agent/memories/get" \
-H "x-api-key: $MEMANTO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"ids": [
"3f2a9c1e-5b7d-4e2a-9c1e-5b7d4e2a9c1e"
]
}'
{
"status": "success",
"message": "Successfully retrieved 1 items from agent 'my-agent'.",
"requested_count": 1,
"found_count": 1,
"items": [
{
"id": "3f2a9c1e-5b7d-4e2a-9c1e-5b7d4e2a9c1e",
"text": "[PREFERENCE] Dark mode\n\nThe user prefers dark mode\n\nTags: ui",
"memory_type": "preference",
"status": "active",
"provenance": "explicit_statement",
"source": "my-app",
"title": "Dark mode",
"confidence": 0.9,
"tags": [
"ui"
],
"expired_at": null,
"expired_by": null,
"metadata": {
"actor_id": "my-agent"
}
}
]
}
Memories
Get Memories
Fetch memories by ID.
POST
/
agents
/
{agent_id}
/
memories
/
get
curl -X POST "https://api.memanto.ai/agents/my-agent/memories/get" \
-H "x-api-key: $MEMANTO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"ids": [
"3f2a9c1e-5b7d-4e2a-9c1e-5b7d4e2a9c1e"
]
}'
{
"status": "success",
"message": "Successfully retrieved 1 items from agent 'my-agent'.",
"requested_count": 1,
"found_count": 1,
"items": [
{
"id": "3f2a9c1e-5b7d-4e2a-9c1e-5b7d4e2a9c1e",
"text": "[PREFERENCE] Dark mode\n\nThe user prefers dark mode\n\nTags: ui",
"memory_type": "preference",
"status": "active",
"provenance": "explicit_statement",
"source": "my-app",
"title": "Dark mode",
"confidence": 0.9,
"tags": [
"ui"
],
"expired_at": null,
"expired_by": null,
"metadata": {
"actor_id": "my-agent"
}
}
]
}
Overview
Returns the memories with the given IDs. When some IDs aren’t found, the status is207 with status: "partial" and the missing IDs in not_found_ids.
Authentication
Your Memanto Cloud API key (
mk_...). See Authentication.Path Parameters
Body
text is the stored memory card: a [TYPE] title line, the content, and a Tags: line.
curl -X POST "https://api.memanto.ai/agents/my-agent/memories/get" \
-H "x-api-key: $MEMANTO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"ids": [
"3f2a9c1e-5b7d-4e2a-9c1e-5b7d4e2a9c1e"
]
}'
{
"status": "success",
"message": "Successfully retrieved 1 items from agent 'my-agent'.",
"requested_count": 1,
"found_count": 1,
"items": [
{
"id": "3f2a9c1e-5b7d-4e2a-9c1e-5b7d4e2a9c1e",
"text": "[PREFERENCE] Dark mode\n\nThe user prefers dark mode\n\nTags: ui",
"memory_type": "preference",
"status": "active",
"provenance": "explicit_statement",
"source": "my-app",
"title": "Dark mode",
"confidence": 0.9,
"tags": [
"ui"
],
"expired_at": null,
"expired_by": null,
"metadata": {
"actor_id": "my-agent"
}
}
]
}