删除规则标签
更新时间:2026-11-17
概述
调用接口,可删除当前租户草稿机器人下的自定义规则标签(V2)及其全部子规则,包括启用和禁用的子规则。
删除成功后,该标签不再出现在该草稿机器人的规则标签列表中,也不再参与该草稿配置的规则匹配。
URL
https://aiob-open.baidu.com/api/v1/robot/label/rule/delete
HTTP Method
POST
请求参数
HEADER
| 参数名称 | 是否必须 | 说明 | 示例 |
|---|---|---|---|
| Authorization | 是 | 参考“生成认证Token”文档获取完整的 OpenAPI Token,原样传入,不加 Bearer 前缀。 | cc-api-auth-v2/your_token |
| Content-Type | 是 | 请求体采用 JSON 格式。 | application/json |
PARAM
以下参数通过 JSON 请求体传入。
| 参数名称 | 是否必须 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| robotId | 是 | String | 当前租户的草稿机器人 ID,不能为空,且须与标签所属机器人一致。线上机器人 ID 不会自动转换为草稿 ID。 | "11111111-1111-4111-8111-111111111111" |
| id | 是 | String | 待删除的标签 ID,从创建、列表或详情接口返回中取得。不是子规则 ID。 | "22222222-2222-4222-8222-222222222222" |
说明:
- 操作范围由 Authorization 所属租户确定。机器人或标签不存在、已删除、不属于当前租户,或机器人不是草稿时,删除失败;标签须属于传入的 robotId。
- 请求只需 robotId 和 id,无需传入 status、version、tenantId 或子规则列表。删除按标签 ID 操作,不以 version 作为并发校验条件,删除的是该标签当前已保存的配置。
- 启用、禁用状态的标签均可删除,无需先禁用父标签或子规则。本接口不检查启用子规则的数量上限,没有子规则时也可以删除标签。
- 父标签及其全部子规则在同一事务中完成删除。无需逐条传入子规则 ID,子规则的启用状态不影响删除范围。
- 删除成功后,再次提交相同 id 会因标签不存在而失败。
- 删除后的标签详情查询返回标签不存在,旧标签 ID 不能继续用于修改、启用或禁用。如需重新配置,应重新创建标签及子规则,使用新返回的 ID。
- 本接口只删除草稿配置中的标签及子规则,不执行机器人发布,也不自动修改关联线上机器人的标签。草稿尚未发布时,正式外呼继续使用原线上配置;等待缓存刷新不能替代发布。需要线上使用删除后的配置时,请通过现有机器人发布流程操作。
- 请求超时、结果不确定时,可先使用 robotId 和 id 查询标签详情,再决定是否重试。详情查询读取指定机器人已保存的标签配置,无需等待通话运行时的规则缓存刷新;正式外呼是否命中不能作为本次草稿删除是否保存成功的判断依据。
响应参数
公共响应字段:
| 字段名称 | 数据类型 | 说明 |
|---|---|---|
| requestId | string | 请求标识,用于定位请求。 |
| time | long | 响应时间戳,单位为毫秒。 |
| code | int | 业务结果码,200 表示标签及其子规则删除成功。 |
| msg | string | 处理结果说明。 |
| data | object / null | 无业务数据,不返回已删除的标签或子规则详情。空值形式沿用公共响应封装,调用方无需读取其具体内容。 |
请求示例
Text
1POST https://aiob-open.baidu.com/api/v1/robot/label/rule/delete
JSON
1{
2 "robotId": "11111111-1111-4111-8111-111111111111",
3 "id": "22222222-2222-4222-8222-222222222222"
4}
robotId、id 需替换为当前租户的实际草稿机器人 ID 及该机器人下的标签 ID。请求头中的 your_token 需替换为实际 Token。
返回示例
以下示例以空对象展示 data,本接口无需解析该字段;根据 code=200 判断本次删除成功。
JSON
1{
2 "requestId": "example-request-id",
3 "time": 1794787200000,
4 "code": 200,
5 "msg": "OK",
6 "data": {}
7}
评价此篇文章
