Delete Role Memory

Last Updated on : 2026-02-26 09:17:07download

Based on the device ID, delete the memory for the specified AI agent role.

API address

DELETE: /v1.0/cloud/agent/ai/chat/b/devices/{device_id}/memories

Request parameter

Parameter name	Type	IN	Required	Description
device_id	String	path	true	The ID of the specified device.
bind_role_type	Integer	query	true	The type of role to bind. Valid values: `0`: Custom role `1`: Template-based role `2`: Single role (There is no role, and data is at the agent level) When `role_id` has a value, this parameter value must be passed.
role_id	String	query	true	The ID of the specified role.
clear_all_memory	Boolean	query	true	Specifies whether to clear all memories.
memory_keys	String	query	false	The list of up to 20 memory keys, separated by commas (,). This value must be passed when `clear_all_memory` is `false`.

Return parameter

Parameter name	Type	Description
result	boolean	Indicates whether the operation is successful.

Request example

DELETE: /v1.0/cloud/agent/ai/chat/b/devices/{device_id}/memories

{
  "device_id": "6c3585ebfe301b40a8u***",
  "bind_role_type": 1,
  "role_id": "94300***",
  "clear_all_memory": false,
  "memory_keys": "sys.memoryInterests,sys.memoryBirthday"
}

Return example

{
    "tid": "6fa034fc1a6d11f0a8212220de940dcb",
    "result": true,
    "t": 1744771778112,
    "success": true
}

Error code

For more information, see error code.