Skip to main content

​
Welcome to the MemoryPlugin API

The MemoryPlugin API lets you store, retrieve, and search memories programmatically, and query your imported chat history. It is the same API the browser extension and integrations use.

MemoryPlugin API Specification

View the complete OpenAPI specification

​
Base URL

All API requests should be made to: 
https://www.memoryplugin.com

​
Authentication

Every endpoint requires your API token. Get it from the dashboard: open Settings → Integrations and copy your token. Include it as a bearer token in the request headers: 
Authorization: Bearer YOUR_API_TOKEN
Treat the token like a password. It grants full access to your memories and chat history, and you can regenerate it from the same settings tab if it leaks.

​
Response Format

Endpoints return plain JSON objects. There is no shared envelope; each endpoint documents its own response shape. For example, GET /api/v2/memory returns: 
{
  "memories": [
    "Prefers concise answers without preamble",
    "Works as a product designer at a fintech startup"
  ],
  "buckets": [
    { "id": 1, "name": "General" },
    { "id": 2, "name": "Work" }
  ]
}

​
Error Handling

Errors use standard HTTP status codes (400 for invalid input, 401 for a missing or bad token, 404 when something does not exist) with a JSON body: 
{
  "error": "Human-readable error message"
}

​
Available Endpoints

  • Memory endpoints: store, retrieve, search, update, and delete memories
  • Bucket endpoints: list and create memory buckets
  • Chat history endpoints: recall, search, upload, and manage imported conversations
Explore the endpoint documentation for request and response details.