API Reference
The Memorer REST API is available at https://api.memorer.ai/v1.
All endpoints require authentication via an API key in the Authorization header:
Authorization: Bearer mem_sk_...Endpoints
Knowledge
| Method | Path | Description |
|---|---|---|
POST | /v1/sdk/query | Query the knowledge graph |
POST | /v1/sdk/ingest | Ingest documents |
GET | /v1/sdk/relationships | List relationships |
GET | /v1/sdk/graph | Get graph visualization data |
Memories
| Method | Path | Description |
|---|---|---|
GET | /v1/memories | List memories |
GET | /v1/memories/:id | Get a memory |
DELETE | /v1/memories/:id | Delete a memory (soft delete) |
GET | /v1/memories/direct | List direct memories |
GET | /v1/memories/derived | List derived memories |
GET | /v1/memories/stats/summary | Get memory statistics |
GET | /v1/memories/episodes | List episodes |
POST | /v1/memories/episodes/create | Create episode |
POST | /v1/memories/consolidate | Run adaptive forgetting |
Entities
| Method | Path | Description |
|---|---|---|
GET | /v1/sdk/entities | List entities |
GET | /v1/sdk/entities/:id | Get an entity |
PUT | /v1/sdk/entities/:id | Update an entity |
DELETE | /v1/sdk/entities/:id | Delete an entity (soft delete) |
GET | /v1/sdk/entities/:id/relationships | Get entity relationships |
Graph
| Method | Path | Description |
|---|---|---|
GET | /v1/sdk/communities | List communities |
POST | /v1/sdk/communities/detect | Run community detection |
GET | /v1/sdk/deduplication/find-duplicates | Find duplicate entities |
POST | /v1/sdk/deduplication/merge | Merge duplicate entities |
Conversations
| Method | Path | Description |
|---|---|---|
POST | /v1/sdk/conversations | Create conversation |
GET | /v1/sdk/conversations | List conversations |
GET | /v1/sdk/conversations/:id | Get conversation |
PATCH | /v1/sdk/conversations/:id | Update conversation |
DELETE | /v1/sdk/conversations/:id | Delete conversation |
POST | /v1/sdk/conversations/:id/messages | Add message |
POST | /v1/sdk/conversations/:id/messages/batch | Add messages (batch) |
GET | /v1/sdk/conversations/:id/messages | Get messages |
POST | /v1/sdk/conversations/:id/recall | Recall with conversation context |
Health
| Method | Path | Description |
|---|---|---|
GET | /health | Health check |
GET | /health/status | Detailed status |
Common parameters
All list endpoints support pagination:
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | int | 50 | Results per page |
offset | int | 0 | Pagination offset |
owner_id | str | — | Filter by user |
Last updated on