# 说明

创建项目里程碑

# url

https://apiv2.tapd.tencent.com/workspace_milestones

# 支持格式

JSON/XML（默认JSON格式）

# HTTP请求方式

POST

# 请求参数

字段名	必选	类型及范围	说明	特殊规则
workspace_id	`是`	integer	项目ID	无
name	`是`	string	标题	无
due	`是`	datetime	计划完成时间	无
description	否	string	详细描述	无
color	否	string	颜色	候选值参考文档下方说明
creator	否	string	创建人	无

# 调用示例及返回结果

# 创建项目里程碑

# curl 使用 Basic Auth 鉴权调用示例

curl -u 'api_user:api_password' -d 'workspace_id=10104801&name=第一阶段&due=2024-05-30&description=123&creator=xxxx' 'https://apiv2.tapd.tencent.com/workspace_milestones'

# curl 使用 OAuth Access Token 鉴权调用示例

curl -H 'Authorization: Bearer ACCESS_TOKEN' -d 'workspace_id=10104801&name=第一阶段&due=2024-05-30&description=123&creator=xxxx' 'https://apiv2.tapd.tencent.com/workspace_milestones'

# 返回结果

{
    "status": 1,
    "data": {
        "WorkspaceMilestone": {
            "id": "1010104801000008548",
            "workspace_id": "10104801",
            "name": "第一阶段",
            "icon": "",
            "description": "123",
            "color": "",
            "status": "open",
            "due": "2025-05-30",
            "completed": "--",
            "line_id": "0",
            "created": "2025-05-20 10:06:12",
            "creator": "v_xuanfang",
            "modified": "2025-05-20 10:06:12",
            "modifier": "v_xuanfang"
        }
    },
    "info": "success"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

# 里程碑相关字段说明

# color参数候选值说明

取值
#0D68FF
#00B3EB
#A576EE
#7C8597
#FF6770
#FE66A8
#FAA23B
#28AB80
#70B400
#F7C100
#7E84FF

# 里程碑相关重要字段说明

字段	说明
id	id
name	标题
workspace_id	项目ID
color	颜色
icon	图标
status	状态: open 开启，done 结束
description	详细描述
due	计划完成时间
completed	实际完成时间
created	创建时间
creator	创建者的名字
modified	最后修改时间
modifier	最后修改人

← 获取项目里程碑支线创建项目里程碑支线 →