Delete Custom Role

Last Updated on : 2026-02-26 09:15:49download

Based on the device ID and role ID, delete the specified custom role for the AI ​​agent.

API address

DELETE: /v1.0/cloud/agent/ai/chat/b/devices/{device_id}/custom-roles/{role_id}

Request parameter

Parameter nameTypeINRequiredDescription
device_idStringpathtrueThe ID of the specified device.
role_idStringpathtrueThe ID of the specified role.

Return parameter

Parameter nameTypeDescription
resultbooleanIndicates whether the operation is successful.

Request example

DELETE: /v1.0/cloud/agent/ai/chat/b/devices/{device_id}/custom-roles/{role_id}
{
  "device_id": "6c3585ebfe301b40a8u***",
  "role_id": "162600***"
}

Return example

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

Error code

For more information, see error code.