删除角色实例

请求信息

请求 URI

DELETE https://lg.jimitu.top/api/open/characters/{id}

请求头参数

请求头	必填	说明
Authorization	是	Bearer {API Key}，接口鉴权，所有请求均需携带
Content-Type	否	仅 POST/PUT 携带 JSON 请求体时需要，值为 application/json

请求路径参数

参数	类型	必填	说明
id	integer	是	角色实例 ID

请求示例

curl -X DELETE "https://lg.jimitu.top/api/open/characters/{id}" \
  -H "Authorization: Bearer <your_api_key>"

响应信息

响应体示例

{
  "success": true,
  "message": "Character deleted"
}

⚠️ 重要提示：通常不建议使用

本接口删除的是角色实例（智能体），不是设备。删除后，关联设备可能变成“空智能体”，设备绑定或运行时会出现 DEVICE_CHARACTER_NOT_FOUND 等错误。

只有在确认不再使用该角色、并准备通过灵格后台重新创建/授权设备角色时，才建议调用本接口。普通设备解绑、换绑不应调用本接口。

错误码

错误码

error_code	状态码	说明
CHARACTER_NOT_FOUND	404	角色不存在