创建任务 - Teambition API

创建任务

curl --location --request POST 'https://open.teambition.com/api/v3/task/create' \ --header 'Authorization: Bearer <appAccessToken>' \ --header 'X-Tenant-Id: 50c32af35a87e6b2...' \ --header 'X-Tenant-Type: organization' \ --header 'Content-Type: application/json' \ --data-raw '{ "projectId": "string", "content": "string", "executorId": "string", "involveMembers": "string", "stageId": "string", "tasklistId": "string", "taskflowstatusId": "string", "startDate": "string", "dueDate": "string", "note": "string", "priority": "string", "parentTaskId": "string", "visible": "string", "scenariofieldconfigId": "string", " customfields": [ { "cfId": "string", "customfieldName": "string", "value": [ { "id": "string", "title": "string", "description": "string", "thumbUrl": "string", "url": "string", "meta": "string" } ] } ] }'

{ " result": { "id": "string", "taskId": "string", "content": "string", "note": "string", "projectId": [ "string" ], "ancestorIds": "string", "parentTaskId": "string", "tfsId": "string", "tasklistId": "string", "stageId": "string", "tagIds": [ "string" ], "creatorId": "string", "executorId": "string", "involveMembers": [ "string" ], "priority": 0, "recurrence": [ "string" ], "isDone": true, "isArchived": true, "visible": "string", "uniqueId": "string", "startDate": "string", "dueDate": "string", "accomplishTime": "string", "created": "string", "updated": "string", "sfcId": "string", "customfields": [ { "cfId": "string", "type": "string", "value": [ { "id": "string", "title": "string", "metaString": "string" } ] } ] }, "code": "string", "errorMessage": "string" }

请求参数

Header 参数

Authorization

string

可选

默认值:

X-Tenant-Id

string

企业 ID

可选

默认值:

X-Tenant-Type

string

可选

默认值:

organization

Body 参数application/json

projectId

string

项目id

必需

content

string

任务标题

必需

executorId

string

执行者id

可选

involveMembers

string

参与者用户ID列表

可选

stageId

string

任务列id

可选

tasklistId

string

任务组id

可选

taskflowstatusId

string

任务状态id

可选

startDate

string

开始日期

可选

dueDate

string

截止日期

可选

note

string

任务备注

可选

priority

string

执行优先级

可选

parentTaskId

string

父任务id

可选

visible

string

可选

任务的可见性规则 involves | members

scenariofieldconfigId

string

任务类型id

可选

customfields

array [object {3}]

自定义字段值列表

可选

cfId

string

自定义字段值ID

可选

customfieldName

string

自定义字段名字

可选

value

array [object {6}]

自定义字段值列表

可选

示例

返回响应

🟢200成功

application/json

Body

result

object

复制后的任务数据

必需

string

任务ID

必需

taskId

string

任务ID

必需

content

string

任务标题

必需

note

string

任务备注

必需

projectId

array[string]

项目ID

必需

ancestorIds

string

祖先任务ID列表

必需

parentTaskId

string

父任务ID

必需

tfsId

string

任务状态ID

必需

tasklistId

string

任务分组ID

必需

stageId

string

任务列ID

必需

tagIds

array[string]

标签ID集合

必需

creatorId

string

创建人ID

必需

executorId

string

执行人ID

必需

involveMembers

array[string]

参与者ID集合

必需

priority

integer

任务优先级

必需

recurrence

array[string]

重复规则

必需

isDone

boolean

是否任务已完成

必需

isArchived

boolean

是否任务放入回收站

必需

visible

string

必需

任务隐私性，'involves'表达仅参与者可见; 'members'表达项目成员可见

uniqueId

string

任务数字ID

必需

startDate

string

必需

任务开始时间(UTC)

dueDate

string

必需

任务截止时间(UTC)

accomplishTime

string

必需

任务完成时间(UTC)

created

string

创建时间(UTC)

必需

updated

string

更新时间(UTC)

必需

sfcId

string

任务类型ID

必需

customfields

array [object {3}]

自定义字段值集合

必需

code

string

响应状态码

必需

errorMessage

string

异常错误信息

必需