文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 记忆库/ 记忆库标签管理/ 批量删除记忆库标签 - BatchDeleteCoreSpaceTags
更新时间:2026-07-06 GMT+08:00
分享

批量删除记忆库标签 - BatchDeleteCoreSpaceTags

功能介绍

该接口用于批量删除记忆库的资源标签。

适用场景:

为记忆库资源批量删除标签。

调用方法

请参见如何调用API

URI

POST /v1/memory-space/{space_id}/tags/delete

表1 路径参数

参数

是否必选

参数类型

描述

space_id

String

参数解释:

记忆库 ID,唯一标识一个记忆库,可以通过AgentArts智能体记忆库控制台或者记忆库查询接口获取。

约束限制:

仅支持字母、数字和中划线。

取值范围:

匹配标准的UUID格式(8-4-4-4-12的十六进制数字串,由连字符分隔),符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

默认取值:

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tags

Array of CoreSpaceTagForPostTMS objects

参数解释:

标签键值对列表。

约束限制:

不涉及。

取值范围:

0-20个。

默认取值:

不涉及。

表3 CoreSpaceTagForPostTMS

参数

是否必选

参数类型

描述

key

String

参数解释:

标签键。

约束限制:

不涉及。

取值范围:

长度1-128字符。

每个值最大长度255个unicode字符。最大长度128个unicode字符。key不能为空。key不能为空或者空字符串,不能为空格。可用 UTF-8 格式表示的字母(包含中文、西班牙语、葡语等)、数字和空格,以及以下字符: _ . : / = + - @。

默认取值:

不涉及。

value

String

参数解释:

标签值。

约束限制:

不涉及。

取值范围:

长度0-255字符。

每个值最大长度255个unicode字符。可用 UTF-8 格式表示的字母(包含中文、西班牙语、葡语等)、数字和空格,以及以下字符: _ . : / = + - @。

默认取值:

不涉及。

响应参数

状态码:204

操作成功,无响应内容。

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息,描述错误详情,供问题排查使用。

取值范围:

不涉及。

状态码:401

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息,描述错误详情,供问题排查使用。

取值范围:

不涉及。

状态码:403

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息,描述错误详情,供问题排查使用。

取值范围:

不涉及。

encoded_authorization_message

String

参数解释:

编码后的授权失败信息。

取值范围:

不涉及。

details

Array of CoreSpaceCommonError objects

参数解释:

依赖的下游服务错误信息列表,包含导致当前请求失败的下游服务错误详情。

取值范围:

不涉及。

表7 CoreSpaceCommonError

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息,描述错误详情,供问题排查使用。

取值范围:

不涉及。

状态码:404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息,描述错误详情,供问题排查使用。

取值范围:

不涉及。

状态码:429

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息,描述错误详情,供问题排查使用。

取值范围:

不涉及。

状态码:500

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息,描述错误详情,供问题排查使用。

取值范围:

不涉及。

请求示例

删除单个标签

/v1/memory-space/123e4567-e89b-12d3-a456-426614174000/tags/delete

{
  "tags" : [ {
    "key" : "appid",
    "value" : "testApp"
  } ]
}

响应示例

状态码

状态码

描述

204

操作成功,无响应内容。

400

请求参数错误。

401

认证失败。

403

权限不足。

404

记忆库未找到

429

请求频率超限。

500

内部服务器错误

错误码

请参见错误码

相关文档