Skip to contentMemoryRouterDocs
IntegrationsData and imports

MemoryRouter / Documentation

Share Links

Send memories to another MemoryRouter account with a link and a password. The receiver imports a copy into their own vault.

Share Links

A share link sends memories from your vault to someone with a different MemoryRouter account. You create a link and a password, hand both to the other person, and they import a copy into their own vault. Neither side ever sees the other's memory key.

Use Transfer and Graft when both keys are yours. Use a share link when the other vault belongs to someone else.

How it works

  • Link: https://app.memoryrouter.ai/transfer/<token>. The link alone shows nothing.
  • Password: generated for you, in the form MR-K7QM-4XTP-9HNW-2DFC. It is shown once. You can replace it later, but never read it back.
  • Frozen: the link points at a fixed list of memories chosen when you create it. Conversations you have afterward are not included. To share something new, create a new link.
  • A copy: the receiver owns their copy. Revoking a link stops future imports and does not remove copies that were already imported.
  • Defaults: one-time use (one account) and a 7 day expiry. Multi-use and no expiry are options.
  • Free: importing costs nothing. Imported memories count toward the receiver's storage like any others.

Shared memories can contain anything you ever told your AI, including credentials. Share selected memories instead of a whole vault when you can, and check the preview first.

From the dashboard

Send: open Memory Keys, find Share with another user, pick the vault, choose selected memories (search queries plus a similarity threshold, default 60%) or the whole vault, then press Preview and Create share link. Copy the link and the password and send them to the other person, ideally through two different channels. The same panel lists your links with their imports, and lets you revoke a link or replace its password.

Receive: open the link, sign in or create an account, enter the password, pick the vault to import into, and press Import.

By talking to your AI

With the MemoryRouter connector attached you can say "make a share link for everything about the Acme project", and the other person can paste the link and password to their AI and say "import this".

ToolWhat it does
create_memory_sharePreviews first. Creates the link after you confirm with the phrase CREATE SHARE LINK.
import_memory_shareShows who shared it and how much. Imports after you confirm with IMPORT SHARED MEMORIES.
list_memory_sharesLists links made from the connected vault.
revoke_memory_shareRevokes a link by id.

Creating a link needs read and write access on the connection. These tools are not listed in the ChatGPT app yet. Use the dashboard there.

API

All endpoints are under https://api.memoryrouter.ai/v1/memory/shares and use your Memory Key as the bearer token. The sender authenticates with the source key. The receiver authenticates with the key that should receive the copy.

EndpointWhoWhat it does
POST /SenderCreate. Body: scope (selected or all), queries, threshold (default 0.6), max_uses (default 1, null for unlimited), expires_in_days (default 7, null for no expiry), label, dry_run.
GET /SenderList links made from this vault.
GET /:idSenderOne link with its import log.
DELETE /:idSenderRevoke.
POST /:id/passwordSenderReplace the password.
POST /unlockReceiverBody: token (or the full link) and password. Returns the summary. Does not use up the link.
POST /redeemReceiverSame body. Claims a use and starts the import.
POST /redemptions/:id/continueReceiverCopies the next batch. Call until continue is false.
GET /redemptions/:idReceiverProgress and final counts.
# Preview, then create
curl -s https://api.memoryrouter.ai/v1/memory/shares \
  -H "Authorization: Bearer $MEMORYROUTER_KEY" -H "Content-Type: application/json" \
  -d '{"scope":"selected","queries":["Acme project decisions"],"dry_run":true}'

curl -s https://api.memoryrouter.ai/v1/memory/shares \
  -H "Authorization: Bearer $MEMORYROUTER_KEY" -H "Content-Type: application/json" \
  -d '{"scope":"selected","queries":["Acme project decisions"],"label":"Acme handoff"}'

The create response returns link and password once. A large import returns "continue": true. Keep calling the continue endpoint until it is false. A repeated call never copies a memory twice.

Security notes

  • Only a SHA-256 hash of the link token and a scrypt hash of the password are stored.
  • Five wrong passwords lock a link for 15 minutes, and the lock doubles each round. Every unlock failure returns the same message, so a link cannot be probed.
  • A one-time link can be claimed by one account. If that import is interrupted, the same account can resume it.
  • Imported memories are stamped with the share id as their origin, never with any part of the sender's key.
  • The link and password are saved in conversation memory like any other turn, so you can ask your AI for them again later. Revoke a link when it is no longer needed.
  • Share links work with personal Memory Keys. Organization keys are not supported yet.

On this page