Forget memories by ID

Remove exact memories from normal recall while preserving their audit history. Each ID is handled independently and any missing or ineligible memory is reported without rolling back successful changes.

DELETE /ns/{namespace}/memories

TypeScript

TypeScript

const options = {
  method: 'DELETE',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({ids: ['mem_abc123']})
};

fetch('https://api.supermemory.ai/ns/{namespace}/memories', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "count": 4503599627370495,
  "errors": [
    {
      "id": "<string>",
      "error": "<string>"
    }
  ],
  "matches": [
    {
      "id": "<string>",
      "memory": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

namespace · string · required

Namespace containing the memories to forget. This can be an ID for your user, a project ID, or any other identifier you wish to use to scope memories.

Maximum string length: 100

Pattern: ^[a-zA-Z0-9_:-]+$

Example:

"user_alex"

Body

application/json

ids · string[] · required

Memory identifiers to remove from normal recall

Required array length: 1 - 500 elements

Stable memory identifier

Minimum string length: 1

Example:

["mem_abc123"]

Response

200

application/json

Exact memory forget completed

count · integer · required

Number of memories matched by this operation

Required range: 0 <= x <= 9007199254740991

errors · object[] · required

Per-memory failures for exact-ID requests

Show child attributes

matches · object[] · required

Memories selected by the operation, whether previewed or forgotten

Show child attributes