---
title: "Delete Memory"
method: DELETE
path: "/memories/{memory_id}"
tags: ["Memories"]
---

# Delete Memory

`DELETE /memories/{memory_id}`

## Request

- Base URL: `https://api.getmetacognition.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getmetacognition.com/memories/{memory_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/metacognition/apis/tex-api/docs/memories/:memory_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete a memory by id, from every store it lives in.

Goes through the single deletion path (``deletion.delete_memory``): the
active-tier copy, the engine node and the vectors that name it, the
copies consolidation made of it, the deleted-memories ledger and its edit
history. This route used to tombstone only the engine node, so the
active copy kept answering recall and consolidation could write the text
back. Tombstones are hidden from every read path; bytes are reclaimed by
the sleep cycle, not here.

## Path parameters

- `memory_id` string, required

## Query parameters

- `scope` string, nullable: Accepted for compatibility: "<kind>:<value>", must be within the caller's visible scopes. The delete is made in the memory's own scope, read from the memory itself.

## Response `200`

Successful Response

- MemoryDeleteResponse: Response from memory deletion.
  - `success` boolean, required: Whether deletion succeeded
  - `message` string: Status message

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/metacognition/apis/tex-api.md) - [All operations](https://skmtc.dev/metacognition/apis/tex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metacognition/apis/tex-api/revisions/3bef47e50f2e?raw)