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. |
Request Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer JWT token. |
| Content-Type | Yes | application/json. |
Request Body Schema
| 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. |
Example Request
{
"memories": [{ "memoryId": "mem_abc123" }]
}
Response Body Schema
| 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. |
Example Response
Status: 200 OK
{
"statusCode": "deleted",
"memories": [{ "memoryId": "mem_abc123", "content": "" }]
}
Error Codes
| 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. |