Skip to main content

​
Endpoint

GET /v1/memory/:id

​
Response (200)

{
  "id": "7cf4b433-4bb2-4522-980e-ad3ee4f270b9",
  "type": "semantic",
  "key": "facts/project-alpha",
  "content": "Project Alpha uses Rust for the backend.",
  "version": 1,
  "isLatest": true,
  "pinned": false,
  "importance": 0.8,
  "isCompressed": false,
  "sizeBytes": 42,
  "mimeType": null,
  "metadata": { "tags": ["project"], "visibility": "private" },
  "encryptionProvider": null,
  "encryptionMeta": null,
  "createdAt": "2026-03-23T19:29:58.023Z",
  "updatedAt": "2026-03-23T19:29:58.023Z"
}

​
Binary Content

For file uploads, content is returned as base64: 
{
  "content": "JVBERi0xLjQK...",
  "contentEncoding": "base64",
  "mimeType": "application/pdf"
}

​
Compressed Content

Compressed content is automatically decompressed — the response always contains the original text.

​
Download Endpoint

For raw binary downloads: 
GET /v1/memory/:id/download
Returns the raw file with correct Content-Type and Content-Disposition headers.

​
Credit Cost

This operation costs 1 credit (memory.read).

​
Errors

StatusReason
404Memory not found or doesn’t belong to your agent