Delete a memory node

Permanently delete an entity node and every fact connected to it.

The card-level "forget this topic" delete: the node, its fact edges in both directions, and their search-overlay rows are removed from both stores. Episodic source content is not touched — per-record erasure stays a separate concern (clear erases everything for the pair).

Scoping follows the fact delete: the calling user's id prefix, not agent_id (kept for URL shape); graph_id targets a shared namespace instead, service tokens only.

Responses: 404 when the node isn't in the requested scope; 422 MEMORY_NODE_PROTECTED for structural nodes (the user's own User node, Topic and Value taxonomy nodes), which are never deletable.

DELETE

https://truememory-api.mvstg.com/memories/{agent_id}/nodes/{node_id}

View as Markdown

Authorization

HTTPBearerHTTPrequired

Path parameters

agent_idstringrequired
node_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

node_idstringrequired
facts_deletedintegerrequired
statusoptionalstring
default: "deleted"

422

Validation Error

JSON

detailoptionalarray ofobject
- locarray ofrequired
  One of the following:
  string
  integer
- msgstringrequired
- typestringrequired
- inputoptionalunknown
- ctxoptionalobject
}