更新任务基础信息
POST
/topapi/workspace/task/update最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口更新任务基础信息。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 否 | — | — |
第三方企业应用 | 是 | 开发者后台申请 | 调试 |
第三方个人应用 | 否 | — | — |
请求参数
Query 参数
access_token
string
必需
调用服务端接口的授权凭证。第三方企业应用可通过调用get_corp_token接口获取。
示例值:
6d1bxxxx
Body 参数application/json
microapp_agent_id
number
可选
微应用的agentId。
task
object
请求入参。
source_id
string
可选
任务来源sourceId。
is_recycled
boolean
是否放入回收站。
gmt_modified
string
修改时间。
executor_userid
string
可选
执行者userid。传null不更新,传空字符串则清空原值。
subject
string
任务标题。
is_archived
boolean
是否归档。
modifier_userid
string
可选
更新者的userid。
description
string
可选
任务描述。传null不更新,传空字符串则清空原值。
priority
number
可选
优先级:10:较低20:普通30:紧急40:非常紧急
parent_id
string
父任务id。
task_type_id
number
任务类型id。
status_id
number
工作流状态id。
status_stage
number
可选
状态阶段:0:开始阶段1:进行阶段2:完成阶段
finish_date
string
可选
任务实际完成时间。传null不更新,传Date(0),即1970-01-01T08:00:00.000+08:00则清空原值。
start_date
string
可选
任务实际开始日期。传null不更新,传Date(0),即1970-01-01T08:00:00.000+08:00则清空原值。
task_type_category
string
可选
任务类型分类:TASK("task"): 任务REQ("req"):需求BUG("bug"):缺陷RISK("risk"):风险WORKITEM("workitem"):工作项
plan_start_date
string
可选
任务计划开始时间。传null不更新,传Date(0),即1970-01-01T08:00:00.000+08:00则清空原值。
plan_finish_date
string
可选
任务计划完成时间。传null不更新,传Date(0),即1970-01-01T08:00:00.000+08:00则清空原值。
tracker_userids
array[string]
任务参与者列表。
extension
object
任务的扩展字段。
corp_id
string
可选
任务所属项目(虚拟企业)。基于项目空间的项目。
source
string
可选
任务来源source。
operator_userid
string
可选
操作者的userid。
task_id
string
必需
任务ID,可通过获取任务详情接口获取。
示例
{
"microapp_agent_id": 868810166,
"operator_userid": "8456259",
"task_id": "pushW1YI2SswiEiExxxx",
"task": {
"source_id": "51ynzjcpw72k",
"is_recycled": false,
"gmt_modified": "2020-07-11 12:15:00",
"executor_userid": "user01",
"subject": "新人学习",
"is_archived": false,
"modifier_userid": "user03",
"description": "更新",
"priority": 10,
"parent_id": "11",
"status_stage": 1,
"corp_id": "dinge8a56572fxxxx"
}
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
errcode
number
返回码。
errmsg
string
返回码描述。
示例
{
"errcode": 0,
"errmsg": "string"
}
最后修改时间: 2 年前