Retrieve the full content and metadata of a specific memory document.
Endpoint
GET /api/memory/get?memory_id=<id>
Query parameters
The unique identifier of the memory document to retrieve
Response
Whether the operation succeeded
The memory document
Memory scope (personal or shared)
Source reference (e.g., project:org/repo)
Creation timestamp (ISO 8601)
Last update timestamp (ISO 8601)
Whether the memory is pinned (always included in search)
Memory priority (affects scoring)
Example
curl -X GET "https://your-cems-server.com/api/memory/get?memory_id=550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer $CEMS_API_KEY"
{
"success": true,
"document": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"content": "I prefer using TypeScript for all new backend services",
"category": "preferences",
"scope": "personal",
"source_ref": null,
"tags": ["typescript", "backend"],
"created_at": "2024-02-28T10:30:00Z",
"updated_at": "2024-02-28T10:30:00Z",
"is_pinned": false,
"priority": 1.0
}
}
Use cases
- Retrieve full memory details for editing
- Verify memory content after creation
- Export individual memories
- Debug search results
Error responses
Error message if the request fails
400 - Bad request (missing memory_id)401 - Unauthorized (invalid or missing API key)404 - Memory not found or access denied500 - Internal server error