更新标签¶

更新指定用户标签的名称和说明。更新不会自动改变已关联用户的其他信息。

POST https://moi.matrixorigin.cn/newmoi/user/tag/update

调用前准备¶

先选择用户标签。

准备具有目标工作区相应权限的个人访问令牌和目标工作区 ID。

请求参数¶

输入示例

curl -X POST "https://moi.matrixorigin.cn/newmoi/user/tag/update" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 1001,
    "name": "example",
    "description": "示例标签"
  }'

参数说明

参数	类型	是否必填	说明
id	integer	是	标签 ID。
name	string	是	标签名称。
description	string	否	更新后的标签说明；省略时保存为空字符串。

标签名称使用与创建标签相同的字符和长度限制。该请求会同时写入名称和说明。

成功响应¶

成功时返回已更新的标签 ID。

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "id": 12
  }
}

字段说明

字段	类型	说明
code	string	成功时为 OK。
msg	string	成功时为 OK。
data.id	integer	已更新的标签 ID。

错误响应¶

响应示例

{
  "code": "INVALID_ARGUMENT",
  "msg": "请求参数无效",
  "data": null
}

字段说明

字段	类型	说明
code	string	错误代码。
msg	string	错误信息。
data	null	—

最后更新于 2026 年 9 月 3 日