创建 Tag

POST

/work_item/tags

创建一个 Tag。每个用户最多 10 个 Tag（超过返 4113），同一用户下名称唯一（重复返 4114）。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

{
    "name": "重要",
    "color": "#FF0000"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '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": "#FF0000"
}'

返回响应

🟢200

application/json

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

4006 workspace_not_found

4113 data_limit_exceeded（Tag 已达 10 个上限，data.limit=10）

4114 name_already_exists（同名，data.name）

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

Bodyapplication/json

示例

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 5,
        "name": "重要",
        "color": "#FF0000",
        "order": 1
    }
}

🟠400

🟠401

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

删除工作项

Tag 列表