---
title: "Delete Memory"
method: DELETE
path: "/datamates/memory/{memory_id}"
tags: ["MEMORY"]
deprecated: true
---

# Delete Memory

`DELETE /datamates/memory/{memory_id}`

> **Deprecated.**

Delete a specific memory from the system.

## Path parameters

- `memory_id` string, required

## Response `200`

Successful Response

- MemoryResponse — Envelope returned by the create, update and delete memory routes. ``/search`` and ``/list`` do not use this model — they declare ``response_model=list[dict]`` and return the service's rows directly. ``message`` is the only field the memory Lambda has always returned. The remaining fields exist on some responses and are surfaced here because ``response_model`` filtering would otherwise discard them before any caller sees them. ``result`` carries the memory-store payload for a create, including the id of the record that was written. Without it a client has to re-list and match on its own metadata to discover the id of the record it just created. ``extracted`` reports whether the Lambda's extraction step produced a structured memory. **It is not a stored/not-stored signal.** Two responses carry ``extracted=False``: * the extractor declined the content — no ``result``, nothing was stored; * the extractor errored and the Lambda fell back to storing the raw messages — ``result`` is present and the content *was* stored. Callers deciding whether a record exists must therefore test ``result``, not ``extracted``. Every added field is optional: update and delete responses carry none of them, and a declined create carries ``extracted`` without ``result``.
  - `message` string, required
  - `result` union
    - MemoryWriteResults — The envelope a create is observed to return. Captured from the live service: ``{"results": [{"id": ..., "event": "ADD", ...}]}``. Modelled explicitly so the id is discoverable in the schema rather than by inspection.
      - `results` MemoryRecordRef[], required
        - `id` string, nullable
        - `memory` string, nullable
        - `event` string, nullable
        - `user_id` string, nullable
        - `metadata` object, nullable
    - MemoryRecordRef[]
      - `id` string, nullable
      - `memory` string, nullable
      - `event` string, nullable
      - `user_id` string, nullable
      - `metadata` object, nullable
    - unknown
  - `extracted` boolean, nullable
  - `memory_type` string, nullable
  - `confidence` number, nullable

## Other responses

- `400` — Invalid request
- `403` — Forbidden
- `422` — Validation Error

## Changes

- **2026-08-25** `64fc5b1ea2a2` — 4 info
  - added the optional property `confidence` to the response with the `200` status
  - added the optional property `extracted` to the response with the `200` status
  - added the optional property `memory_type` to the response with the `200` status
  - added the optional property `result` to the response with the `200` status

[Change history](https://skmtc.dev/myaltimate/apis/fastapi/changes/datamates/memory/:memory_id/delete.md)

---

[API](https://skmtc.dev/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.dev/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/myaltimate/fastapi/revisions/ec5d4d08b843/schema)