更新 Tag

PUT

/work_item/tags/{tag_id}

更新 Tag 的名称和颜色（整体覆盖，两个字段都必填）。名称改后仍受唯一性约束。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Header 参数

Body 参数application/json必填

示例

{
    "name": "非常重要",
    "color": "#CC0000"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://app.emooai.com/open-api/v1/work_item/tags/' \
--header 'Emoo-User-Id: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "非常重要",
    "color": "#CC0000"
}'

返回响应

🟢200

application/json

成功（code=200）或业务错误。可能错误码：

4006 workspace_not_found

4012 data_not_found（tag_id 不存在或不属于当前用户）

4114 name_already_exists（改名后撞已有）

4084 invalid_open_api_user_id（缺 Emoo-User-Id 或用户不存在）

Bodyapplication/json

示例

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 0,
        "name": "string",
        "color": "string",
        "order": 0
    }
}

🟠400

🟠401

修改于 2026-09-09 15:48:35

Tag 列表

删除 Tag