创建项目create project by template

POST

https://dev.worktile.com/open-api/mission/project

// 需先根据模板id获取项目表单设置，创建项目接口会校验必填项
{
    "data_retention_options": [], // 保留数据选项（9.59.3 版本支持）
    "template_name": "敏捷开发",  // 模板名称，必填
    "name": "用模版创建项目",  // 项目名称，必填
    "visibility": 1, //是否公开项目1=公开，2=私有 必填
    "members": [
        "5fd9ba644c013158dee44660"
    ] // 必须传入最少一个用户id作为团队成员，并且第一个成员默认为项目管理员
    state_id: "正常", // 状态
    state_desc: "", // 状态描述
    "attachments": ["6969da98baa89600b5ef7608"], // 附件，传入附件id
    "ext":{ // 项目概览组件中负责人，开始时间，截止时间，自定义属性的初始化
        assignee：："",
        start:,
        due:,
        properties:[{name:"",value:""}]
    }
}

请求参数

Query 参数

Body 参数application/json

示例

{
    "data_retention_options": [
        "projectMember",
        "projectProperty",
        "projectAttachment",
        "task",
        "taskProperty",
        "taskMilestone",
        "taskAttachment",
        "taskDependence",
        "estimatedWorkload"
    ],
    "template_name": "项目管理",
    "name": "OPEN API 创建公开项目 2",
    "visibility": 1,
    "members": [
        "9d9f17dc466349d08b781da8df9dcc0a"
    ],
    "ext": {
        "start": 1634709177,
        "due": 1634709177,
        "properties": [
            {
                "name": "数字属性",
                "value": -29783618
            },
            {
                "name": "数字属性",
                "value": "eiusmod ipsum quis aute"
            },
            {
                "name": "数字属性",
                "value": -70671162
            }
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'https://dev.worktile.com/open-api/mission/project?access_token={tenant_access_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data_retention_options": [
        "projectMember",
        "projectProperty",
        "projectAttachment",
        "task",
        "taskProperty",
        "taskMilestone",
        "taskAttachment",
        "taskDependence",
        "estimatedWorkload"
    ],
    "template_name": "项目管理",
    "name": "OPEN API 创建公开项目 2",
    "visibility": 1,
    "members": [
        "9d9f17dc466349d08b781da8df9dcc0a"
    ],
    "ext": {
        "start": 1634709177,
        "due": 1634709177,
        "properties": [
            {
                "name": "数字属性",
                "value": -29783618
            },
            {
                "name": "数字属性",
                "value": "eiusmod ipsum quis aute"
            },
            {
                "name": "数字属性",
                "value": -70671162
            }
        ]
    }
}'

返回响应

🔴500create project by template

text/plain

示例

{
    "_id": "62302b9a9f170763466c6a52", //项目编号
    "name": "OPEN API 创建项目 2", //项目名称
    "members": [ //项目成员
        {
            "uid": "9d9f17dc466349d08b781da8df9dcc0a",
            "display_name": "htz",
            "name": "htz"
        }
    ],
    "visibility": "私有" //是否公开项目
}

修改于 2026-02-27 07:18:17

获取部门

获取项目 get-projects-by-page