# Supermemory integration

> Memory and context API for AI agents: ingest documents, search memories, user profiles, connectors and namespaces.

- Authentication: apiKey

## Tools (81)

- **Add document**: Turn text or a supported URL into searchable, evolving memory.
- **Add document (v3)**: Legacy: Add a document with any content type (text, url, file, etc.) and metadata.
- **Add or update profile buckets**: Teach Supermemory new ways to organize this namespace's profile, or refine how existing namespace-owned buckets are classified.
- **Batch add documents**: Build a knowledge base efficiently by ingesting up to 600 text or URL documents at once.
- **Batch add documents (v3)**: Legacy: Add multiple documents in a single request.
- **Bulk delete documents (v3)**: Legacy: Bulk delete documents by IDs or container tags.
- **Configure connection (v3)**: Legacy: Configure resources for a connection (supported providers: GitHub for now).
- **Create connection (v3)**: Legacy: Initialize connection and get authorization URL.
- **Create connector**: Connect an external source to this namespace.
- **Create memories directly (v4)**: Legacy: Create memories directly, bypassing the document ingestion workflow.
- **Create Scoped API Key**: Mint an API key restricted to one namespace.
- **Delete connection by ID (v3)**: Legacy: Delete a specific connection by ID.
- **Delete connection (v3)**: Legacy: Delete connection for a specific provider and container tags.
- **Delete connector**: Disconnect a connector and stop its webhooks.
- **Delete container tag (v3)**: Legacy: Delete a container tag and all its documents and memories.
- **Delete document by ID or customId (v3)**: Legacy: Delete a document by ID or customId.
- **Delete documents**: Permanently remove documents and their derived knowledge by document ID or caller-defined ID.
- **Delete namespace**: Retire a namespace by permanently deleting its content, or preserve that knowledge by moving everything into another namespace first.
- **Delete profile buckets**: Remove profile categories created specifically for this namespace.
- **Disable Scoped API Key**: Revoke a namespace-scoped API key.
- **Fetch resources (v3)**: Legacy: Fetch resources for a connection (supported providers: GitHub for now).
- **Forget a memory (v4)**: Legacy: Forget (soft delete) a memory entry.
- **Forget memories by ID**: Remove exact memories from normal recall while preserving their audit history.
- **Forget memories matching a prompt/query (v4)**: Legacy: Agentic mass-forget.
- **Forget memories semantically**: Describe what should be forgotten in natural language, then preview or apply the matching set.
- **Get Analytics Errors**: Error counts, top errors and timeline.
- **Get Analytics Logs**: Request logs for debugging and auditing.
- **Get Analytics Usage**: Request counts, per-key and hourly usage statistics.
- **Get Billing Summary**: Plan, usage and reset date for the organization.
- **Get Billing Usage**: Per-feature usage and limits for the billing period.
- **Get Billing Usage Events**: Meter events by day and feature.
- **Get connection (by id) (v3)**: Legacy: Get connection details with id.
- **Get connection (by provider) (v3)**: Legacy: Get connection details with provider and container tags.
- **Get connector**: Read one connector.
- **Get container tag merge status (v3)**: Legacy: Get queued container tag merge status.
- **Get container tag settings (v3)**: Legacy: Get settings for a container tag.
- **Get document**: Retrieve a document's canonical content, metadata, and processing state by document ID or caller-defined ID.
- **Get document chunks (v3)**: Legacy: Get all chunks for a document, ordered by position.
- **Get document (v3)**: Legacy: Get a document by ID.
- **Get memory**: Retrieve one memory by ID.
- **Get namespace settings**: Read the supporting context that helps Supermemory understand content and form better memories inside this namespace.
- **Get organization settings**: Read the shared background that guides memory formation across the organization, together with the number of active namespaces.
- **Get presigned file URL (v3)**: Legacy: Get a fresh presigned URL for a document's file.
- **Get processing documents (v3)**: Legacy: Get documents that are currently being processed.
- **Get profile**: Read a continuously maintained understanding of the subject represented by this namespace.
- **Get profile buckets**: Inspect the profile taxonomy active in this namespace.
- **Get profile buckets (v4)**: Legacy: Returns the effective profile bucket definitions for a given container tag — org-level buckets merged with any container-tag-level additions.
- **Get settings (v3)**: Legacy: Get settings for an organization.
- **Get user profile (v4)**: Legacy: Get user profile with optional search results.
- **Ingest or update conversation (v4)**: Legacy: Ingest or update a conversation.
- **List all connectors**: List connectors across every namespace this key can read.
- **List all container tags (v3)**: Legacy: List all container tags with isNova flag.
- **List connection documents (v3)**: Legacy: List documents indexed for a provider and container tags.
- **List connections (v3)**: Legacy: List all connections.
- **List connectors**: List the connectors that sync into this namespace.
- **List documents (v3)**: Legacy: Retrieves a paginated list of documents with their metadata and workflow status.
- **List memory entries with history (v4)**: Legacy: List all latest memory entries from specified container tags with their update history and source documents.
- **List namespaces**: Discover every namespace available to the caller, including its purpose, document volume, memory count, and lifecycle timestamps.
- **List namespaces (alias)**: Discover every namespace available to the caller, including its purpose, document volume, memory count, and lifecycle timestamps.
- **List resources**: Browse documents, source chunks, or learned memories through one predictable paginated contract.
- **Merge container tags (v3)**: Legacy: Merge multiple container tags into a target tag.
- **Partially update document file**: Refresh only the file-backed fields you provide.
- **Replace document with file**: Replace an existing document with a new file while keeping its stable document ID.
- **Reset organization data (v3)**: Legacy: Reset organization content: removes documents, memories, spaces (except default project), connections, and org settings.
- **Search documents (v3)**: Legacy: Search memories with advanced filtering.
- **Search memories**: Recall the most relevant learned context and source passages from a namespace.
- **Search memory entries (v4)**: Legacy: Search memory entries - Low latency for conversational.
- **Send feedback**: Report a bug, request a feature or flag a docs problem to the Supermemory team.
- **Suggest profile buckets (v3)**: Legacy: Suggest profile bucket definitions based on the organization context prompt.
- **Sync connection (v3)**: Legacy: Initiate a manual sync of connections.
- **Sync connector**: Start a sync now.
- **Update a memory (creates new version) (v4)**: Legacy: Update a memory by creating a new version.
- **Update connector**: Change what a connector syncs.
- **Update container tag settings (v3)**: Legacy: Update settings for a container tag.
- **Update document**: Refresh an existing document without changing its stable ID.
- **Update document (v3)**: Legacy: Update a document with any content type (text, url, file, etc.) and metadata.
- **Update namespace settings**: Shape how Supermemory understands an existing namespace by updating the background context used during ingestion and memory formation.
- **Update organization settings**: Give Supermemory organization-wide background that improves how content is interpreted across every namespace.
- **Update settings (v3)**: Legacy: Update settings for an organization.
- **Upload a file (v3)**: Legacy: Upload a file to be processed.
- **Upload file**: Transform an uploaded file into searchable knowledge and learned memory.

Connect Supermemory in General Input: https://www.generalinput.com/apps/supermemory