Teambition API

更新任务

POSThttps://open.teambition.com/api/task/update

该接口用于更新任务。

请求参数

Header 参数

Content-Type

string

可选

示例值:

application/json

operatorId

string

操作人的用户 ID

必需

taskId

string

任务 ID

必需

projectId

string

项目 ID

可选

templateId

string

可选

任务类型 ID，通过查询任务类型接口获取

tasklistId

string

可选

任务类型 ID，通过查询任务类型接口获取

taskgroupId

string

可选

任务类型 ID，通过查询任务类型接口获取

content

string

可选

任务内容，最长为 500 个字符

executorId

string

可选

执行者的用户 ID，不传表示待认领

statusId

string

可选

工作流状态 ID，通过查询工作流信息接口获取

sprintId

string

可选

迭代 ID，通过获取迭代信息接口回去迭代信息

startDate

string

开始日期

可选

dueDate

string

截止日期

可选

accomplishDate

string

可选

完成时间（普通项目任务可以通过该字段完成任务）

note

string

任务备注

可选

priority

integer

可选

优先级： 0：普通（默认值） 1：紧急 2：非常紧急

visible

string

可选

parentTaskId

string

可选

父任务 ID，传此参数相当于创建了一个子任务

participants

array[string]

可选

参与者的用户 ID 列表

customfields

array [object {3}]

自定义字段列表

可选

cfId

string

可选

自定义字段 ID，调用查询任务类型接口，返回结果中包含自定义字段 ID

visible

string

可选

可见性： participants：任务参与者可见 projectMembers：项目成员可见（默认值）

value

array[string]

自定义字段值

可选

{
  "operatorId": "5a28e2036176bbde...",
  "taskId": "5e141eaf7fd0daf8...",
  "projectId": "5e0d98527d161c00...",
  "templateId": "5e1421647fd0daf8...",
  "tasklistId": "5d5798a2d4268209...",
  "taskgroupId": "5d5798a2d4268209...",
  "content": "第一个任务",
  "executorId": "5a28e2036176bbde...",
  "statusId": "5e142164aef01b07...",
  "startDate": "2019-12-01T10:30:00Z",
  "dueDate": "2019-12-05T18:00:00Z",
  "accomplishDate": "2019-12-05T23:00:00Z",
  "note": "第一个任务",
  "priority": 0,
  "visible": "projectMembers",
  "parentTaskId": "",
  "participants": [
    "5a28e2036176bbde.."
  ],
  "customfields": [
    {
      "cfId": "5e11b2b7ed69f340...",
      "value": [
        "abc"
      ]
    }
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

integer

必需

返回码，200 表示成功

errorMessage

string

必需

调用失败时的错误信息

result

object (result)

必需

taskId

string

任务 ID

必需

projectId

string

项目 ID

必需

templateId

string

任务类型 ID

必需

tasklistId

string

任务列表 ID

必需

taskgroupId

string

任务分组 ID

必需

content

string

任务内容

必需

executorId

string

执行者的用户 ID

必需

statusId

string

工作流状态 ID

必需

sprintId

string

迭代 ID

必需

startDate

string

开始时间

必需

dueDate

string

截止时间

必需

accomplishDate

string

完成时间

必需

note

string

任务备注

必需

priority

integer

必需

优先级： 0：普通（默认值） 1：紧急 2：非常紧急

visible

string

必需

可见性： participants：任务参与者可见 projectMembers：项目成员可见（默认值）

parentTaskId

string

父任务 ID

必需

ancestorIds

array[string]

必需

所有祖先任务，ancestorIds[0] 为直接父任务，ancestorIds[1] 为父任务的父任务，以此类推

participants

array[string]

必需

参与者的用户 ID 列表

customfields

array[object (customfields) {2}]

自定义字段列表

必需

isDone

integer

是否完成

必需

creatorId

string

创建人的用户 ID

必需

created

string

任务创建时间

必需

modifierId

string

必需

最近一次执行更新操作的用户 ID

updated

string

最近一次更新时间

必需

{
  "code": 200,
  "errorMessage": "",
  "result": {
    "taskId": "5e141eaf7fd0daf8...",
    "projectId": "5e0d98527d161c00...",
    "templateId": "5e1421647fd0daf8...",
    "tasklistId": "5d5798a2d4268209...",
    "taskgroupId": "5d5798a2d4268209...",
    "content": "第一个任务",
    "executorId": "5a28e2036176bbde...",
    "statusId": "5e142164aef01b07...",
    "startDate": "2019-12-01T10:30:00Z",
    "dueDate": "2019-12-05T18:00:00Z",
    "note": "第一个任务",
    "priority": 0,
    "visible": "projectMembers",
    "parentTaskId": "",
    "ancestorIds": [],
    "participants": [
      "5a28e2036176bbde..."
    ],
    "customfields": [
      {
        "cfId": "5e11b2b7ed69f340...",
        "value": [
          "abc"
        ]
      }
    ],
    "isDone": 0,
    "creatorId": "5a28e2036176bbde...",
    "created": "2019-12-01T10:30:00Z",
    "modifierId": "5a28e2036176bbde...",
    "updated": "2020-01-07T11:00:00Z"
  }
}

最后修改时间： 3 年前