Skip to content
Navigation

Delete a memory (deprecated — use /edges/{edge_id})

Permanently delete a memory edge by UUID (hard delete, both stores).

Deprecated — the path doesn't say what it deletes now that node deletion exists alongside it. Use DELETE /memories/{agent_id}/edges/ {edge_id} (same behavior) or .../nodes/{node_id}. This route keeps serving unchanged until existing callers migrate.

The lookup is scoped by the calling user's id, not by agent_id — so callers don't need to know which of the user's agents originally produced the memory. The agent_id path parameter is preserved for URL backwards-compatibility but is not used to constrain the search. Edge UUIDs are globally unique; the user-id prefix match still prevents cross-user deletion.

With graph_id, the edge is deleted from that shared namespace instead — service tokens only.

Returns 404 if the edge isn't in the requested scope (or doesn't exist).

DELETE
https://truememory-api.mvstg.com/memories/{agent_id}/{memory_id}
View as Markdown

Authorization

  • HTTPBearerHTTPrequired

Path parameters

  • agent_idstringrequired
  • memory_idstringrequired

Query parameters

  • graph_idoptional

    Optional. Delete from a shared namespace instead of the user's own memory. Requires a service token; the agent_id path segment is ignored.

    One of the following:

    • string
    • null

Header parameters

  • X-On-Behalf-Ofoptional

    One of the following:

    • string
    • null
  • X-External-User-Idoptional

    One of the following:

    • string
    • null
  • X-App-Idoptional

    One of the following:

    • string
    • null

Returns

200

Successful Response

JSON
  • memory_idstringrequired
  • statusoptionalstring
    default: "deleted"

422

Validation Error
JSON
  • detailoptionalarray ofobject
    • locarray ofrequired

      One of the following:

      • string
      • integer
    • msgstringrequired
    • typestringrequired
    • inputoptionalunknown
    • ctxoptionalobject

Type to search…

↑↓ navigate↵ selectEsc close