Base URL
/api/.
Authentication
Every request must include an API key in theX-API-Key header:
Endpoints
| Method | Path | Description |
|---|---|---|
POST | /api/memories | Save a memory |
GET | /api/memories | List memories |
GET | /api/memories/search | Search memories |
GET | /api/memories/profile | Get user profile context |
GET | /api/memories/{id} | Get a memory by ID |
PATCH | /api/memories/{id} | Update a memory |
DELETE | /api/memories/{id} | Delete a memory |
POST | /api/memories/{id}/forget | Forget a memory (soft delete) |
GET | /api/memories/{id}/history | Get memory version history |
POST | /api/memories/{id}/feedback | Submit feedback |
Response format
All successful responses return JSON. Error responses follow a consistent shape:X-Request-Id header for tracing.
Rate limits
Rate-limited endpoints return the following headers:| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests in the current window. |
X-RateLimit-Remaining | Requests remaining in the current window. |
X-RateLimit-Reset | Unix timestamp when the window resets. |
Request limits
- Maximum request body size: 50 KB.
- Memory content maximum length: 10,000 characters.
- Search query maximum length: 1,000 characters.
