# supermemory | Memory API for the AI era

## Docs

- [Ingesting context to supermemory](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/add-memories.md): Add text, files, and URLs to Supermemory
- [Configure connection](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/connections/configure-connection.md): Configure resources for a connection (supported providers: GitHub for now)
- [Create connection](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/connections/create-connection.md): Initialize connection and get authorization URL
- [Delete connection](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/connections/delete-connection.md): Delete connection for a specific provider and container tags
- [Delete connection by ID](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/connections/delete-connection-by-id.md): Delete a specific connection by ID
- [Fetch resources](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/connections/fetch-resources.md): Fetch resources for a connection (supported providers: GitHub for now)
- [Get connection (by id)](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/connections/get-connection-by-id.md): Get connection details with id
- [Get connection (by provider)](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/connections/get-connection-by-provider.md): Get connection details with provider and container tags
- [List connections](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/connections/list-connections.md): List all connections
- [List documents](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/connections/list-documents.md): List documents indexed for a provider and container tags
- [Sync connection](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/connections/sync-connection.md): Initiate a manual sync of connections
- [Delete container tag](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/container-tags/delete-container-tag.md): Delete a container tag and all its documents and memories. Only organization owners and admins can perform this action.
- [Get container tag settings](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/container-tags/get-container-tag-settings.md): Get settings for a container tag
- [Merge container tags](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/container-tags/merge-container-tags.md): Merge multiple container tags into a target tag. All documents from the source tags will be updated to reference the target tag, and the source tags will be deleted after successful merge.
- [Update container tag settings](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/container-tags/update-container-tag-settings.md): Update settings for a container tag
- [Create memories directly](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/content-management/create-memories-directly.md): Create memories directly, bypassing the document ingestion workflow. Generates embeddings and makes them immediately searchable.
- [Forget a memory](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/content-management/forget-a-memory.md): Forget (soft delete) a memory entry. The memory is marked as forgotten but not permanently deleted.
- [List memory entries with history](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/content-management/list-memory-entries-with-history.md): List all latest memory entries from specified container tags with their update history and source documents
- [Update a memory (creates new version)](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/content-management/update-a-memory-creates-new-version.md): Update a memory by creating a new version. The original memory is preserved with isLatest=false.
- [Get document](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/documents/get-document.md): Get a document by ID
- [Get document chunks](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/documents/get-document-chunks.md): Get all chunks for a document, ordered by position
- [Get processing documents](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/documents/get-processing-documents.md): Get documents that are currently being processed
- [List documents](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/documents/list-documents.md): Retrieves a paginated list of documents with their metadata and workflow status
- [Search documents](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/documents/search-documents.md): Search memories with advanced filtering
- [Add document](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/ingest/add-document.md): Add a document with any content type (text, url, file, etc.) and metadata
- [Batch add documents](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/ingest/batch-add-documents.md): Add multiple documents in a single request. Each document can have any content type (text, url, file, etc.) and metadata
- [Bulk delete documents](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/ingest/bulk-delete-documents.md): Bulk delete documents by IDs or container tags
- [Delete document by ID or customId](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/ingest/delete-document-by-id-or-customid.md): Delete a document by ID or customId
- [Ingest or update conversation](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/ingest/ingest-or-update-conversation.md): Ingest or update a conversation
- [Update document](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/ingest/update-document.md): Update a document with any content type (text, url, file, etc.) and metadata
- [Upload a file](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/ingest/upload-a-file.md): Upload a file to be processed
- [Get graph bounds](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/knowledge-graph/get-graph-bounds.md): Get the bounding box of all documents with spatial coordinates
- [Get graph statistics](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/knowledge-graph/get-graph-statistics.md): Get summary statistics for the graph
- [Get graph viewport data](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/knowledge-graph/get-graph-viewport-data.md): Fetch documents (with memories) and memory edges within a viewport
- [Get user profile](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/profiles/get-user-profile.md): Get user profile with optional search results
- [Search memory entries](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/recall-search/search-memory-entries.md): Search memory entries - Low latency for conversational
- [Get settings](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/settings/get-settings.md): Get settings for an organization
- [Reset organization data](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/settings/reset-organization-data.md): Reset organization content: removes documents, memories, spaces (except default project), connections, and org settings. Preserves the org, members, and billing.
- [Toggle overage](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/settings/toggle-overage.md): Toggle overage billing for the organization
- [Update settings](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/api-reference/settings/update-settings.md): Update settings for an organization
- [Authentication](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/authentication.md): API keys, scoped keys, and connector branding.
- [Changelog](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/changelog/overview.md): New updates and improvements to Supermemory
- [Supported Content Types](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/concepts/content-types.md): All the content formats Supermemory can ingest and process
- [Customizing for Your Use Case](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/concepts/customization.md): Configure Supermemory's behavior for your specific application
- [Organizing & Filtering Memories](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/concepts/filtering.md): Use container tags and metadata to organize and retrieve memories
- [How Graph Memory Works](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/concepts/graph-memory.md): Automatic memory evolution, knowledge updates, and intelligent forgetting
- [How Supermemory Works](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/concepts/how-it-works.md): Understanding the knowledge graph architecture that powers intelligent memory
- [Memory vs RAG: Understanding the Difference](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/concepts/memory-vs-rag.md): Learn why agent memory and RAG are fundamentally different, and when to use each approach
- [SuperRAG (Managed RAG as a service)](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/concepts/super-rag.md): Supermemory provides a managed RAG solution - extraction, indexing, storing, and retrieval.
- [User Profiles](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/concepts/user-profiles.md): Automatically maintained context about your users
- [GitHub Connector](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/connectors/github.md): Connect GitHub repositories to sync documentation files into your Supermemory knowledge base
- [Gmail Connector](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/connectors/gmail.md): Sync email threads from Gmail with real-time Pub/Sub webhooks and incremental sync
- [Google Drive Connector](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/connectors/google-drive.md): Connect Google Drive to sync documents into your Supermemory knowledge base
- [Notion Connector](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/connectors/notion.md): Sync Notion pages, databases, and blocks with real-time webhooks and workspace integration
- [OneDrive Connector](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/connectors/onedrive.md): Sync Microsoft Office documents from OneDrive with scheduled synchronization and business account support
- [Connectors Overview](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/connectors/overview.md): Integrate Google Drive, Gmail, Notion, OneDrive, GitHub and Web Crawler to automatically sync documents into your knowledge base
- [S3 Connector](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/connectors/s3.md): Connect Amazon S3 or S3-compatible storage to sync files into your Supermemory knowledge base
- [Connector Troubleshooting](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/connectors/troubleshooting.md): Diagnose and resolve common issues with Google Drive, Gmail, Notion, and OneDrive connectors
- [Web Crawler Connector](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/connectors/web-crawler.md): Crawl and sync websites automatically with scheduled recrawling and robots.txt compliance
- [AI SDK Integration](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/cookbook/ai-sdk-integration.md): Complete examples showing how to use Supermemory with Vercel AI SDK for building intelligent applications
- [Chat with Google Drive](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/cookbook/chat-with-gdrive.md)
- [Customer Support Bot](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/cookbook/customer-support.md): Build an intelligent support system that remembers customer history and provides personalized help
- [Document Q&A System](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/cookbook/document-qa.md): Build a chatbot that answers questions from your documents with citations and source references
- [Cookbook](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/cookbook/overview.md): Complete examples and recipes for building with Supermemory
- [Perplexity with memory](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/cookbook/perplexity-supermemory.md)
- [Personal AI Assistant](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/cookbook/personal-assistant.md): Build an AI assistant that remembers user preferences, habits, and context across conversations
- [Document Operations](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/document-operations.md): List, get, update, and delete your ingested documents
- [Microsoft Agent Framework](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/agent-framework.md): Add persistent memory to Microsoft Agent Framework agents with Supermemory
- [Agno](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/agno.md): Add persistent memory to Agno agents with Supermemory
- [Vercel AI SDK](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/ai-sdk.md): Use Supermemory with Vercel AI SDK for seamless memory management
- [Claude Code](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/claude-code.md): Claude Code Supermemory Plugin — persistent memory across coding sessions
- [Claude Memory Tool](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/claude-memory.md): Use Claude's native memory tool with Supermemory as the backend
- [OpenAI Codex](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/codex.md): codex-supermemory — persistent memory for OpenAI Codex CLI
- [CrewAI](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/crewai.md): Add persistent memory to CrewAI agents with Supermemory
- [Hermes](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/hermes.md): Hermes Supermemory Plugin — semantic memory, profiles, and search across Telegram, Discord, Slack, CLI, and more
- [LangChain](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/langchain.md): Build AI agents with persistent memory using LangChain and Supermemory
- [LangGraph](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/langgraph.md): Add persistent memory to LangGraph agents with Supermemory
- [Mastra](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/mastra.md): Add persistent memory to Mastra AI agents with Supermemory processors
- [Memory Graph](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/memory-graph.md): Interactive visualization for documents, memories and connections
- [n8n](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/n8n.md): Automate knowledge management with Supermemory in n8n workflows
- [OpenAI SDK](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/openai.md): Memory tools for OpenAI function calling with Supermemory integration
- [OpenAI Agents SDK](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/openai-agents-sdk.md): Add persistent memory to OpenAI agents with Supermemory
- [OpenClaw](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/openclaw.md): OpenClaw Supermemory Plugin — works across Telegram, WhatsApp, Discord, Slack, and more
- [OpenCode](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/opencode.md): OpenCode Supermemory Plugin — persistent memory across coding sessions
- [Pipecat](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/pipecat.md): Integrate Supermemory with Pipecat for conversational memory in voice AI agents
- [Supermemory SDK](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/supermemory-sdk.md): Official Python and JavaScript SDKs for Supermemory
- [viaSocket](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/viasocket.md): Connect Supermemory with viaSocket to build automation flows using triggers, API tokens, and actions like Gmail.
- [VoltAgent](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/voltagent.md): Integrate Supermemory with VoltAgent for long-term memory in AI agents
- [Zapier](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/integrations/zapier.md): Automate memory management with Supermemory in Zapier workflows
- [Overview — What is Supermemory?](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/intro.md)
- [Managing Connection Resources](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/memory-api/connectors/managing-resources.md): Get and configure resources for connections that support resource management
- [Memory Operations](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/memory-operations.md): Advanced memory operations (v4 API)
- [Architecture](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/memorybench/architecture.md): Understanding MemoryBench's design and implementation
- [CLI Reference](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/memorybench/cli.md): Command-line interface for running MemoryBench evaluations
- [Contributing](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/memorybench/contributing.md): Guidelines for contributing to MemoryBench
- [Extend Benchmark](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/memorybench/extend-benchmark.md): Add a custom benchmark dataset to MemoryBench
- [Extend Provider](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/memorybench/extend-provider.md): Add a custom memory provider to MemoryBench
- [MemoryBench on GitHub](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/memorybench/github.md)
- [Installation](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/memorybench/installation.md): Get MemoryBench up and running in your environment
- [Integrations](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/memorybench/integrations.md): Supported benchmarks and providers in MemoryBench
- [MemScore](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/memorybench/memscore.md): A composite metric for comparing memory providers across quality, latency, and token efficiency
- [MemoryBench](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/memorybench/overview.md): Open-source framework for standardized, reproducible benchmarks of memory layer providers
- [Quick Start](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/memorybench/quickstart.md): Run your first benchmark evaluation in 3 steps
- [Migrating from Mem0 to Supermemory](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/migration/from-mem0.md): Complete guide to migrate your data and applications from Mem0 to Supermemory
- [Migrating from Zep to Supermemory](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/migration/from-zep.md): Quick guide to migrate from Zep to Supermemory
- [Use Cases](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/overview/use-cases.md): What can you do with supermemory?
- [Quickstart](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/quickstart.md): Make your first API call to Supermemory - add and retrieve memories.
- [Search](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/search.md): Semantic search across your memories and documents
- [Claude Desktop](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/supermemory-mcp/claude-desktop.md): Manual setup for supermemory MCP in Claude Desktop with step-by-step screenshots
- [Overview](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/supermemory-mcp/mcp.md): Give your AI assistants persistent memory with the Model Context Protocol
- [Setup and Usage](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/supermemory-mcp/setup.md): How to set up and use Supermemory MCP Server 4.0
- [User Profiles](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/user-profiles.md): Fetch and use automatically maintained user context
- [Vibe Coding Setup](https://supermemory-vorflux-codex-supermemory-plugin.mintlify.app/vibe-coding.md): Automatic Supermemory integration using AI coding agents

## OpenAPI Specs

- [openapi](https://api.supermemory.ai/v3/openapi)

## Optional

- [Your Dashboard](https://console.supermemory.ai)