Delete Memories

Delete one or more memory entries. Identify each entry by its memory ID.

URI: /api/v1/agentic/memory

Format: application/json

HTTP Method: DELETE

Authentication: Bearer JWT

Note: Deletion is permanent. You can’t undo this action.

Query Parameters

Parameter	Type	Required	Description
profile_id	String	Yes	Profile ID of the Individual or User.
profile_type	String	Yes	Type of profile. Values: `individual`, `employee`.
category	String	Yes	Partition key for the memory entries, such as `PROFILE_FACT`.

Header	Required	Description
Authorization	Yes	Bearer JWT token.
Content-Type	Yes	`application/json`.

Field	Type	Required	Description
memories	Array	Yes	Memory entries to delete. Minimum one entry.
memories[].memoryId	String	Yes	Identifier of the memory entry to delete.

1{
2  "memories": [{ "memoryId": "mem_abc123" }]
3}

Field	Type	Description
statusCode	String	Operation status. Value: `deleted`.
memories	Array	The deleted memory entries.
memories[].memoryId	String	Identifier of the deleted memory entry.
memories[].content	String	Empty for deleted entries.

Status: 200 OK

1{
2  "statusCode": "deleted",
3  "memories": [{ "memoryId": "mem_abc123", "content": "" }]
4}

Status Code	Description
400	Bad Request. Invalid request format or missing required fields.
401	Unauthorized. Invalid or missing JWT token.
404	Not Found. The specified memory entry doesn’t exist.
500	Internal Server Error.

DID THIS ARTICLE SOLVE YOUR ISSUE?
Let us know so we can improve!