- Category: artificial intelligence
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 86
- Triggers: 0
- Slug:
SUPERMEMORY - Version: 20261101_00
Tools
Add Document
Add Document
SUPERMEMORY_ADD_DOCUMENTIngest text or a public URL as a Supermemory document and return its document ID and initial processing status.Input Parameters
Output
Add Documents
Add Documents
SUPERMEMORY_ADD_DOCUMENTSAdd 1 to 600 documents in one request, with per-document metadata and processing options. Inspect counts and results for partial failures; the tool raises an error if all documents fail, and the API does not guarantee atomicity or result ordering.Input Parameters
Output
Add Namespace Document
Add Namespace Document
SUPERMEMORY_ADD_NAMESPACE_DOCUMENTAdd text or a supported URL as searchable, evolving memory in an isolated namespace. Supply a new document ID to create a document, or reuse an existing ID to append information while preserving history. Ingestion is asynchronous: inspect the returned processing status and retrieve the document to check completion.Input Parameters
Output
Add Namespace Documents
Add Namespace Documents
SUPERMEMORY_ADD_NAMESPACE_DOCUMENTSIngest 1 to 600 text or URL documents in an isolated namespace. Existing caller-defined IDs append information with single-document ingestion semantics. Acceptance is asynchronous, not completed processing. HTTP 200 may contain partial failures: inspect count, failed, and each result’s error, details, and url. Accepted results precede failures; match by id or failed-item url, not position. An all-failed batch raises an error.Input Parameters
Output
Bulk Delete Documents
Bulk Delete Documents
SUPERMEMORY_BULK_DELETE_DOCUMENTSDeprecated provider v3 endpoint; shuts down December 31, 2026. Use v5 namespace document deletion (DELETE /ns/{namespace}/document) instead. Delete up to 100 documents by ID, all documents in selected container tags, or documents matching a filepath. Container-tag and filepath selectors can delete many documents. Inspect success, deleted_count, and errors for the actual outcome; an HTTP 200 alone does not prove every document was deleted.Input Parameters
Output
Configure Automatic Top-Ups
Configure Automatic Top-Ups
SUPERMEMORY_CONFIGURE_AUTOMATIC_TOPUPSDeprecated legacy v3 API, scheduled to shut down December 31, 2026. Configure automatic paid USD credit purchases for the connected organization. Enabling reloads can cause financial charges when the credit balance is low. Requires an unscoped organization API key with admin or owner access; paid-plan and saved-payment-method requirements apply when enabling. Supply the full console configuration explicitly, including when disabling. Purchase limits do not cap total usage or the full invoice.Input Parameters
Output
Configure Connection
Configure Connection
SUPERMEMORY_CONFIGURE_CONNECTIONDeprecated by the provider: the legacy v3 API shuts down December 31, 2026. Use the v5 namespace connectors API for new integrations. Configure selected resources for an existing legacy connection; currently only GitHub supports resource configuration. Returns the provider’s success flag, outcome message, and optional registered-webhook count.Input Parameters
Output
Count Namespace Document Memories
Count Namespace Document Memories
Create Connection
Create Connection
SUPERMEMORY_CREATE_CONNECTIONDeprecated by the provider: this legacy v3 endpoint shuts down on December 31, 2026. Use CREATE_CONNECTOR for v5 namespace-scoped connectors. Initialize a provider connection and return its ID and any authorization URL. This does not open the URL or complete user authorization; the user must authorize separately before the connection can import documents.Input Parameters
Output
Create Connector
Create Connector
Create Memory
Create Memory
SUPERMEMORY_CREATE_MEMORYDeprecated by the provider; v3/v4 APIs shut down on December 31, 2026. Use v5 namespace document ingestion for new integrations. Create 1 to 100 memories directly in an existing container, bypassing document ingestion. Generates embeddings and makes the memories immediately searchable.Input Parameters
Output
Create Scoped Key
Create Scoped Key
SUPERMEMORY_CREATE_SCOPED_KEYDeprecated legacy v3 route; provider shutdown is December 31, 2026. No v5 scoped-key creation alternative is documented. Create an API key restricted to one namespace or a fixed list of namespaces, using an organization API key; scoped keys cannot mint further keys. Writable scoped keys can update and delete content within their namespaces. Returns a secret credential: store it securely and do not log it.Input Parameters
Output
Delete Connection
Delete Connection
SUPERMEMORY_DELETE_CONNECTIONDeprecated by the provider: this legacy v3 endpoint shuts down on December 31, 2026. Use DELETE_CONNECTOR for v5 namespace-scoped connector deletion instead. Delete a specific connection by ID. By default this also deletes documents imported by the connection; set deleteDocuments to ‘false’ to retain them. Returns deleted connection IDs and providers.Input Parameters
Output
Delete Connector
Delete Connector
SUPERMEMORY_DELETE_CONNECTORDisconnect a connector in a namespace and stop its webhooks. Imported documents are also deleted by default. Set deleteDocuments to false to preserve those documents.Input Parameters
Output
Delete Container Tag
Delete Container Tag
SUPERMEMORY_DELETE_CONTAINER_TAGDeprecated by the provider: the legacy v3 API shuts down on December 31, 2026. Use v5 DELETE /ns/{namespace} to delete a namespace instead. Delete a container tag and all its documents and memories. Only organization owners and admins can perform this destructive action.Input Parameters
Output
Delete Document
Delete Document
Delete Namespace
Delete Namespace
SUPERMEMORY_DELETE_NAMESPACERetire a namespace and permanently delete its documents and memories. Optionally set moveTo to preserve its content by moving everything into another namespace first. A queued response only acknowledges an asynchronous move, not completed deletion; a deleted response confirms permanent removal.Input Parameters
Output
Delete Namespace Documents
Delete Namespace Documents
SUPERMEMORY_DELETE_NAMESPACE_DOCUMENTSPermanently delete 1 to 100 documents and their derived knowledge from a namespace by document ID or caller-defined ID. Each identifier is handled independently; successful deletions are preserved if others fail. Inspect count and every errors entry: HTTP 200 does not mean all documents were deleted.Input Parameters
Output
Delete Namespace Profile Buckets
Delete Namespace Profile Buckets
SUPERMEMORY_DELETE_NAMESPACE_PROFILE_BUCKETSRemove 1 to 50 profile bucket categories created specifically for a namespace and return its updated effective bucket definitions. Unknown names are safely ignored. Organization-wide buckets are protected and cannot be removed with this action. Requires namespace write access.Input Parameters
Output
Delete Provider Connection
Delete Provider Connection
SUPERMEMORY_DELETE_PROVIDER_CONNECTIONDeprecated by the provider: this legacy v3 endpoint shuts down on December 31, 2026. Use DELETE_CONNECTOR for v5 namespace-scoped connector deletion by connector ID instead. Delete connections for a specific provider and container tags. Returns the deleted connection IDs and providers.Input Parameters
Output
Forget Matching Memories
Forget Matching Memories
SUPERMEMORY_FORGET_MATCHING_MEMORIESDeprecated by Supermemory: legacy v3/v4 APIs shut down December 31, 2026. Use v5 DELETE /ns/{namespace}/memories/semantic for semantic forgetting, or DELETE /ns/{namespace}/memories for exact IDs. Soft-delete memories in one container matching a natural-language instruction or exact IDs. Set dry_run=true to preview first; omission defaults to real forgetting. Semantic matches may change between preview and apply; use exact IDs for a reviewable selection.Input Parameters
Output
Forget Memory
Forget Memory
SUPERMEMORY_FORGET_MEMORYDeprecated by the provider; v3/v4 APIs shut down on December 31, 2026. Use v5 DELETE /ns/{namespace}/memories for new integrations. Soft-delete a memory by ID or exact content within a required container tag. The memory is marked as forgotten, not permanently deleted.Input Parameters
Output
Forget Namespace Memories
Forget Namespace Memories
SUPERMEMORY_FORGET_NAMESPACE_MEMORIESRemove 1 to 500 exact memories from normal recall in a namespace by stable memory ID, preserving their audit history. Each ID is handled independently: missing or ineligible memories are reported without rolling back successful changes. Inspect count, errors, and matches; HTTP 200 does not mean every requested memory was forgotten.Input Parameters
Output
Forget Namespace Memories Semantically
Forget Namespace Memories Semantically
SUPERMEMORY_FORGET_NAMESPACE_MEMORIES_SEMANTICALLYPreview or forget memories in a namespace using a natural-language query. Explicitly set dryRun to true to preview or false to apply forgetting. For a reviewable, drift-free workflow, preview here and pass the returned memory IDs to the exact-ID forget action instead of rerunning the query. Inspect count, matches, and errors for the provider-reported outcome.Input Parameters
Output
Get Account Status
Get Account Status
Get Automatic Top-Ups
Get Automatic Top-Ups
SUPERMEMORY_GET_AUTOMATIC_TOPUPSDeprecated legacy v3 API, scheduled to shut down December 31, 2026. Get the connected organization’s automatic credit top-up configuration and payment-method availability without changing billing settings or purchasing credits. Requires an unscoped organization API key; scoped API keys cannot read billing.Output
Get Billing Usage
Get Billing Usage
SUPERMEMORY_GET_BILLING_USAGEDeprecated legacy v3 API; provider shutdown is December 31, 2026. Retrieve the connected organization’s per-feature billing usage, limits, units, and period bounds when available. Requires an organization API key; scoped API keys cannot read billing. Console usage estimates are not authoritative invoices.Output
Get Billing Usage Events
Get Billing Usage Events
SUPERMEMORY_GET_BILLING_USAGE_EVENTSDeprecated legacy v3 API, scheduled to shut down December 31, 2026. Get daily billing meter events for the connected organization, including per-feature consumption and Memory versus SuperRAG token totals. Optional ISO 8601 start and end override the billing period. Requires an organization API key; scoped API keys cannot read billing. Console usage is an estimate; invoice line items are authoritative.Input Parameters
Output
Get Connection
Get Connection
SUPERMEMORY_GET_CONNECTIONDeprecated by the provider: this legacy v3 endpoint shuts down December 31, 2026. Use the v5 GET /ns/{namespace}/connectors/{id} endpoint for new integrations. Retrieve a legacy connection by ID, including available provider metadata and the latest sync run status.Input Parameters
Output
Get Connector
Get Connector
SUPERMEMORY_GET_CONNECTORRead a connector in a namespace, including its setup, selection, and latest sync status. Optionally include the 10 most recent sync runs with failed items or a one-time hosted picker URL. Requesting picker requires admin write access because the link allows changing what syncs.Input Parameters
Output
Get Container Tag
Get Container Tag
SUPERMEMORY_GET_CONTAINER_TAGDeprecated by the provider: this legacy v3 endpoint shuts down on December 31, 2026. Use v5 GET /ns/{namespace} for namespace settings instead. Get a container tag’s display name, entity context, memory filesystem paths, profile buckets, and creation and update timestamps.Input Parameters
Output
Get Container Tag Merge
Get Container Tag Merge
SUPERMEMORY_GET_CONTAINER_TAG_MERGEDeprecated by the provider: this legacy v3 endpoint shuts down on December 31, 2026. Get the status and progress of a queued container tag merge by its merge job ID, including copied rows, renamed custom IDs, and the last error. This read does not start or retry a merge.Input Parameters
Output
Get Document
Get Document
Get Document Chunks
Get Document Chunks
Get Document File URL
Get Document File URL
SUPERMEMORY_GET_DOCUMENT_FILE_URLDeprecated by the provider: this legacy endpoint shuts down December 31, 2026. Get a fresh presigned download URL for a document’s uploaded file. The URL is valid for 24 hours. Returns an error if the document does not exist or has no file.Input Parameters
Output
Get Error Analytics
Get Error Analytics
SUPERMEMORY_GET_ERROR_ANALYTICSDeprecated legacy v3 endpoint scheduled to shut down December 31, 2026. Retrieve organization-wide error analytics, including request-type summaries, HTTP error breakdowns, hourly trends, and per-key metrics for a time window. Returns one page; increment page using the returned pagination metadata.Input Parameters
Output
Get Namespace Settings
Get Namespace Settings
SUPERMEMORY_GET_NAMESPACERead a namespace’s supporting context and lifecycle timestamps. Supporting context helps Supermemory understand content and form better memories inside this namespace.Input Parameters
Output
Get Namespace Document
Get Namespace Document
SUPERMEMORY_GET_NAMESPACE_DOCUMENTRetrieve a document’s canonical content, metadata, and processing state by document ID or caller-defined ID within a namespace. Optionally include source chunks, derived memories, or both. Processing status done does not necessarily mean memory generation is complete; inspect dreamingStatus separately.Input Parameters
Output
Get Namespace Memory
Get Namespace Memory
SUPERMEMORY_GET_NAMESPACE_MEMORYRetrieve one memory by ID within a namespace, including its text, metadata, version, and recall flags. Optionally include version history up to three steps away (nearest first), direct extends and derives links, and source documents. relatedLimit caps each related list separately.Input Parameters
Output
Get Namespace Profile
Get Namespace Profile
Get Namespace Profile Buckets
Get Namespace Profile Buckets
SUPERMEMORY_GET_NAMESPACE_PROFILE_BUCKETSInspect the profile taxonomy active in a Supermemory namespace. Returns a name-to-description map combining organization-wide profile buckets with namespace-owned additions.Input Parameters
Output
Get Organization
Get Organization
Get Profile
Get Profile
SUPERMEMORY_GET_PROFILERetrieve the static, dynamic, or bucketed profile learned for one container tag, optionally with matching search results.Input Parameters
Output
Get Profile Buckets
Get Profile Buckets
SUPERMEMORY_GET_PROFILE_BUCKETSDeprecated by the provider: this legacy v4 endpoint shuts down on December 31, 2026. Use v5 GET /ns/{namespace}/profile/buckets instead. Return the effective profile bucket definitions for a container tag, merging organization-level buckets with container-tag-level additions.Input Parameters
Output
Get Provider Connection
Get Provider Connection
SUPERMEMORY_GET_PROVIDER_CONNECTIONDeprecated by the provider: this legacy v3 endpoint shuts down on December 31, 2026. Use v5 LIST_CONNECTORS to find namespace connectors and GET_CONNECTOR to retrieve one by ID. Retrieve a legacy connection by provider and container tags, including its latest synchronization status when available. This POST only reads connection details.Input Parameters
Output
Get Settings
Get Settings
SUPERMEMORY_GET_SETTINGSDeprecated legacy v3 API, scheduled to shut down December 31, 2026. Use the v5 organization and namespace settings APIs for new integrations. Retrieve the connected organization’s ingestion filters, connector OAuth configuration, chunk size, and profile buckets. Connector client secrets are omitted from the response.Output
Get Usage Analytics
Get Usage Analytics
SUPERMEMORY_GET_USAGE_ANALYTICSDeprecated legacy v3 API, scheduled to shut down December 31, 2026. Get organization-wide request usage analytics, including counts by request type, hourly performance, per-API-key metrics, and total memories. Filter by a relative period or ISO 8601 from_ and to bounds. Returns one page; use pagination to request further pages. Recorded tokensUsed is not the billable ingestion-token meter.Input Parameters
Output
Ingest Conversation
Ingest Conversation
SUPERMEMORY_INGEST_CONVERSATIONDeprecated by the provider: the v3/v4 API shuts down December 31, 2026. For new integrations, ingest a conversation transcript through v5 POST /ns/{namespace}/document instead. Ingest or update a conversation by its conversationId using structured messages, optional container tags, and metadata. Returns the backing document ID and processing status, not a guarantee that asynchronous processing has finished.Input Parameters
Output
List All Connectors
List All Connectors
SUPERMEMORY_LIST_ALL_CONNECTORSList one page of connectors across every namespace the API key can read, optionally filtered by provider. Use for admin views spanning users or projects. Pending connectors are not listed. Increment page up to pagination.totalPages to retrieve subsequent pages.Input Parameters
Output
List Connection Documents
List Connection Documents
SUPERMEMORY_LIST_CONNECTION_DOCUMENTSDeprecated by the provider: this legacy v3 endpoint shuts down on December 31, 2026. For v5 document listing, use LIST_NAMESPACE_RESOURCES with type documents; v5 connectors are namespace-scoped. List documents indexed for a connected provider, optionally filtered by container tags. Returns document IDs, processing statuses, titles, summaries, types, and timestamps.Input Parameters
Output
List Connection Resources
List Connection Resources
SUPERMEMORY_LIST_CONNECTION_RESOURCESDeprecated by the provider: this legacy v3 endpoint shuts down on December 31, 2026. List one page of accessible resources for a connection; only GitHub is currently documented as supported. Use page and per_page to request additional pages, and parent_id to scope resources to a parent.Input Parameters
Output
List Connections
List Connections
SUPERMEMORY_LIST_CONNECTIONSDeprecated by the provider: this legacy v3 endpoint shuts down on December 31, 2026. Use v5 LIST_CONNECTORS for namespace connectors or LIST_ALL_CONNECTORS across namespaces. List all legacy connections, optionally filtered by container tags, including the latest synchronization status when available.Input Parameters
Output
List Connectors
List Connectors
SUPERMEMORY_LIST_CONNECTORSList one page of connectors that sync into a namespace, optionally filtered by provider. Pending authorization connectors are not listed. Use page and limit with the returned pagination metadata to retrieve subsequent pages.Input Parameters
Output
List Documents
List Documents
SUPERMEMORY_LIST_DOCUMENTSList documents, optionally filtered by containers, metadata, or filepath, one page at a time.Input Parameters
Output
List Inferred Memories
List Inferred Memories
SUPERMEMORY_LIST_INFERRED_MEMORIESList a namespace’s inferred memories awaiting review. This review route is still served under v3; pass the namespace as containerTag. Returns up to 50 memories ordered by parentCount descending, then createdAt descending, excluding forgotten, expired, or reviewed memories. No pagination is documented; total can exceed the returned count. Unknown or empty namespaces return an empty list and zero total. No v5 replacement is documented.Input Parameters
Output
List Invoices
List Invoices
SUPERMEMORY_LIST_INVOICESDeprecated legacy v3 API, scheduled to shut down December 31, 2026. List the connected Supermemory organization’s billing invoices without changing billing settings or purchasing credits. Requires an unscoped organization API key; scoped API keys cannot read billing.Output
List Memories
List Memories
List Namespace Resources
List Namespace Resources
SUPERMEMORY_LIST_NAMESPACE_RESOURCESBrowse one page of documents, extracted chunks, or learned memories in a namespace. The other collection arrays are empty. Use pagination.totalPages and page to retrieve further pages. Position sorting is for chunks only; include.content and include.memoryCount apply to documents, and include.forgotten applies to memories.Input Parameters
Output
List Namespaces
List Namespaces
List Processing Documents
List Processing Documents
SUPERMEMORY_LIST_PROCESSING_DOCUMENTSDeprecated by the provider: the legacy v3 API shuts down December 31, 2026. Use the v5 namespace document listing API for new integrations. List the live processing queue, all unfinished documents, or unfinished and failed documents. For view=all, fetch subsequent pages using page and limit and inspect the returned pagination information.Input Parameters
Output
List Request Logs
List Request Logs
SUPERMEMORY_LIST_REQUEST_LOGSDeprecated legacy v3 endpoint scheduled to shut down December 31, 2026. List one page of organization-wide request logs filtered by time. Use pagination metadata and increment page to continue. Outputs are compacted and may be truncated. The ordinary tracker skips HTTP 402, 404, and 500 responses, so logs are not a complete audit trail. Historical retention is not guaranteed. Request type, status code, and API key filters are not supported.Input Parameters
Output
Replace Namespace File
Replace Namespace File
SUPERMEMORY_REPLACE_NAMESPACE_FILEReplace an existing document with a new file within an isolated namespace, keeping its stable document ID. Content and caller metadata are overwritten and the document is reprocessed asynchronously. The returned status reports processing state, not guaranteed completion. Requires namespace write access.Input Parameters
Output
Reset Organization Data
Reset Organization Data
SUPERMEMORY_RESET_ORGANIZATION_DATADeprecated by the provider: this legacy v3 endpoint shuts down on December 31, 2026. Destructively reset the ENTIRE connected organization’s content: delete documents, memories, spaces except the default project, connections, and organization settings, and clear the default space context. Preserves the organization itself, members, and billing. This is not scoped to an individual document, container tag, or namespace. Only call with explicit authorization to delete the entire organization’s data.Input Parameters
Output
Review Inferred Memory
Review Inferred Memory
SUPERMEMORY_REVIEW_INFERRED_MEMORYProvider deprecation notice: legacy v3/v4 APIs are scheduled to shut down December 31, 2026. These review routes still serve namespaces under v3; no v5 replacement is documented. Approve, decline, or undo a review of one inferred memory in a namespace. Approve confirms the fact; decline forgets it and removes it from search; undo restores the unreviewed inferred state, including un-forgetting a declined memory. Requires a key with write access to the namespace. A non-reviewable memory or an undo without a prior review returns 409.Input Parameters
Output
Revoke Scoped Key
Revoke Scoped Key
SUPERMEMORY_REVOKE_SCOPED_KEYDeprecated by the provider: this legacy v3 endpoint shuts down on December 31, 2026. Revoke a scoped API key using the ID returned at creation. Subsequent requests using the revoked key receive 401. Memories and namespaces are not deleted. Authenticate with an organization API key, not a scoped key.Input Parameters
Output
Search Memory
Search Memory
SUPERMEMORY_SEARCH_CONTEXTSemantically search Supermemory memories, document chunks, or both, with optional container and metadata filters.Input Parameters
Output
Search Documents
Search Documents
SUPERMEMORY_SEARCH_DOCUMENTSDeprecated by the provider: legacy v3/v4 APIs shut down December 31, 2026. Use v5 namespace search (POST /ns/{namespace}/search) for new integrations. Search documents and their content chunks with optional container, document, metadata, and filepath filters. Returns one bounded result set with relevance scores and optional full content or summaries.Input Parameters
Output
Search Namespace
Search Namespace
SUPERMEMORY_SEARCH_NAMESPACERecall relevant learned context and source passages from an isolated namespace. Hybrid search combines memories and document chunks by default. Supports typed metadata filters (up to five levels), query rewriting, reranking, and optional source documents and related memories.Input Parameters
Output
Send Feedback
Send Feedback
SUPERMEMORY_SEND_FEEDBACKSend a bug report, feature request, documentation problem, or other feedback to the Supermemory team. This contacts real engineers and consumes the organization’s quota of three submissions per UTC day, subject to a shared authenticated pool of 200 per day. Do not automatically retry uncertain deliveries, including HTTP 502: delivery may already have occurred.Input Parameters
Output
Suggest Profile Buckets
Suggest Profile Buckets
SUPERMEMORY_SUGGEST_PROFILE_BUCKETSDeprecated by the provider: the legacy v3 API shuts down December 31, 2026. Suggest profile bucket definitions using the organization’s saved context prompt. Returns 3 to 6 suggestions tailored to that context without saving bucket definitions. Fails when no organization context is available.Output
Sync Connection
Sync Connection
SUPERMEMORY_SYNC_CONNECTIONDeprecated provider v3 API; shuts down December 31, 2026. For v5, use SYNC_CONNECTOR with a namespace and connector ID instead. Initiate a manual sync of connections for a provider, optionally filtered by container tags. The acknowledgement means importing was accepted, not that sync has finished.Input Parameters
Output
Sync Connector
Sync Connector
Update Connector
Update Connector
SUPERMEMORY_UPDATE_CONNECTORChange what a connector syncs in a namespace or its maximum document count. A supplied selection replaces the old selection and starts a sync. Only send selection for providers that support choosing resources. Returns the updated connector and its latest sync status.Input Parameters
Output
Update Container Tag
Update Container Tag
SUPERMEMORY_UPDATE_CONTAINER_TAGDeprecated by the provider: the legacy v3 API shuts down December 31, 2026. Use the v5 namespace settings API (PATCH /ns/{namespace}) for new integrations. Update an existing container tag’s display name, document processing context, memory filesystem paths, or tag-level profile buckets. Omitted fields remain unchanged; explicit nulls are sent for fields that support them.Input Parameters
Output
Update Document
Update Document
SUPERMEMORY_UPDATE_DOCUMENTUpdate the content, metadata, container, or processing configuration of one existing document. When metadata is supplied, it completely replaces the document’s metadata, so omitted metadata keys are removed.Input Parameters
Output
Update Memory
Update Memory
SUPERMEMORY_UPDATE_MEMORYDeprecated by the provider; v3/v4 APIs shut down on December 31, 2026. Use v5 namespace document updates for document-backed memory changes in new integrations. Update a memory by ID or exact content within a container, creating a new version. The original memory is preserved with isLatest=false. Omitted metadata and expiry inherit from the previous version; explicit null forgetAfter clears the expiry.Input Parameters
Output
Update Namespace
Update Namespace
SUPERMEMORY_UPDATE_NAMESPACEUpdate the background context used during ingestion and memory formation in an existing namespace. Omit supportingContext to leave it unchanged, or explicitly set it to null to clear it. Requires write access.Input Parameters
Output
Update Namespace Document
Update Namespace Document
SUPERMEMORY_UPDATE_NAMESPACE_DOCUMENTPartially update an existing document in an isolated namespace without changing its stable ID. Supplied content replaces canonical content and is reprocessed; omitted fields remain unchanged. Returns the document ID and processing state, not a guarantee of completed processing.Input Parameters
Output
Update Namespace File
Update Namespace File
SUPERMEMORY_UPDATE_NAMESPACE_FILEPartially update a file-backed document in an isolated namespace. Supply a file to replace canonical content, or update metadata and processing context without a file. Omitted metadata and processing context remain unchanged. Returns the document ID and current processing state, not a guarantee of completed processing.Input Parameters
Output
Update Organization
Update Organization
SUPERMEMORY_UPDATE_ORGANIZATIONUpdate organization-wide background that guides content interpretation and memory formation across every namespace. Provide organizationalContext as a nonempty string to set it, or null to remove the existing context. Requires admin access.Input Parameters
Output
Update Settings
Update Settings
SUPERMEMORY_UPDATE_SETTINGSDeprecated by the provider: the legacy v3 API shuts down December 31, 2026. Use v5 organization and namespace settings APIs for new integrations. Update the connected organization’s settings, including filtering, custom connector OAuth credentials, chunk size, and profile buckets. Omitted fields are unchanged; explicit nulls are sent to the provider. This changes live organization configuration. Connector client secrets are accepted as input but omitted from the response.Input Parameters
Output
Upload Document File
Upload Document File
SUPERMEMORY_UPLOAD_DOCUMENT_FILEDeprecated by the provider: this legacy endpoint shuts down December 31, 2026. Use the v5 namespace file upload endpoint POST /ns/{namespace}/document/file for new integrations. Upload a file as a document for processing, with optional container tags, metadata, and extraction settings. The returned status reports processing state and does not guarantee processing has finished.Input Parameters
Output
Upload Namespace File
Upload Namespace File
SUPERMEMORY_UPLOAD_NAMESPACE_FILEUpload a file into an isolated Supermemory namespace to form searchable knowledge and learned memory. Ingestion returns once safely queued; extraction and memory formation continue asynchronously. The returned status is the document’s current processing state, not a guarantee that processing has completed. Use task_type=superrag for retrieval without generating memories.Input Parameters
Output
Add or Update Namespace Profile Buckets
Add or Update Namespace Profile Buckets
SUPERMEMORY_UPSERT_NAMESPACE_PROFILE_BUCKETSAdd or update namespace-owned profile bucket definitions that guide memory classification. Omitted buckets remain unchanged. Organization-wide buckets are protected and cannot be changed. Returns the effective definitions, including organization buckets. Requires namespace write access.