Get Memory

GET /memory/

Retrieve a single memory by its unique identifier. This endpoint is useful for fetching detailed information about a specific memory.

Path Parameters

string

required

The unique identifier of the memory to retrieve.

Response

boolean

Indicates whether the request was successful.

object

The memory object with all its details.

Show Memory Object

string

Unique identifier for the memory.

string

The stored memory fact.

string

The user ID this memory belongs to.

object

Associated metadata including memory_type, timestamps, and custom fields.

Show Metadata Fields

string

Classification of the memory (LONG_TERM, SHORT_TERM, EPISODIC, SEMANTIC, or PROCEDURAL).

string

Where the memory came from (e.g., “conversation”, “screen_capture”).

any

Any custom metadata fields added when creating the memory.

string

Hash of the memory content for deduplication.

string

ISO timestamp when the memory was created.

string

ISO timestamp when the memory was last updated.

Example Request

curl http://localhost:8000/memory/mem_abc123

Example Response

{
  "success": true,
  "memory": {
    "id": "mem_abc123",
    "memory": "User prefers TypeScript over JavaScript for new projects",
    "user_id": "user_123",
    "metadata": {
      "memory_type": "LONG_TERM",
      "source": "conversation",
      "confidence": "high"
    },
    "hash": "a1b2c3d4e5f6",
    "created_at": "2025-03-01T10:00:00Z",
    "updated_at": "2025-03-01T10:00:00Z"
  }
}

Error Response

If the memory ID doesn’t exist:

{
  "detail": "Memory not found"
}

Use Cases

Memory Details

Display detailed information about a specific memory in the UI.

Verify Updates

Confirm that a memory was updated correctly after an edit operation.

Context Validation

Verify memory exists before performing operations that depend on it.

Audit Trail

Retrieve specific memories for debugging or audit purposes.

Source: backend/main.py:308-317

Memory API

Backend API

Electron IPC

GET /memory/

Path Parameters

Response

Example Request

Example Response

Error Response

Use Cases

Memory Details

Verify Updates

Context Validation

Audit Trail

​GET /memory/

​Path Parameters

​Response

​Example Request

​Example Response

​Error Response

​Use Cases

Memory Details

Verify Updates

Context Validation

Audit Trail

​Related Endpoints

GET /memory/

Path Parameters

Response

Example Request

Example Response

Error Response

Use Cases

Related Endpoints