更新自由任务标题新版SDK

更新于 2023-05-12

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，更新自由任务的标题。

例如，在员工小钉的项目中，我的任务列表如下图所示，有一个任务标题为测试任务。

调用本接口可以更新任务标题，将测试任务更新为测试任务1。接口调用成功后的效果如下图所示。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	项目应用中任务写权限	API Explorer
第三方企业应用	支持	项目应用中任务写权限	API Explorer
第三方个人应用	暂不支持	项目应用中任务写权限	暂不支持

请求方法

Header参数

名称	类型	是否必填	描述
x-acs-dingtalk-access-token	String	是	调用该接口的访问凭证。企业内部应用，调用获取企业内部应用的accessToken接口获取。第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

是

调用该接口的访问凭证。

企业内部应用，调用获取企业内部应用的accessToken接口获取。
第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。

Path参数

名称	类型	是否必填	描述
taskId	String	是	任务id。企业内部应用，调用创建自由任务接口获取的id值。第三方企业应用，调用创建自由任务接口获取的id值。
userId	String	是	操作者userId。

名称

类型

是否必填

描述

taskId

String

是

任务id。

企业内部应用，调用创建自由任务接口获取的id值。
第三方企业应用，调用创建自由任务接口获取的id值。

userId

String

是

操作者userId。

Body参数

名称	类型	是否必填	描述
content	String	是	任务标题。
disableActivity	Boolean	否	是否禁止动态。 true：禁止，不显示该任务动态信息。 false：不禁止，显示该任务动态信息。
disableNotification	Boolean	否	是否禁止通知。 true：禁止，不显示通知。 false：不禁止，显示通知。

名称

类型

是否必填

描述

content

String

是

任务标题。

disableActivity

Boolean

否

是否禁止动态。

true：禁止，不显示该任务动态信息。
false：不禁止，显示该任务动态信息。

disableNotification

Boolean

否

是否禁止通知。

true：禁止，不显示通知。
false：不禁止，显示通知。

返回参数

名称	类型	描述
result	Object	返回结果。
content	String	更新后的任务标题。
updated	String	更新任务标题的时间，格式：YYYY-MM-DDTHH:mm:ssZ（ISO 8601/RFC 3339）。说明转换成北京时间，需要在参数时间基础上加8小时。例如参数值为2022-06-20T00:00:00Z，表示的北京时间为2022-06-20 08:00:00。

示例

请求示例

HTTP

Java

Python

PHP

Node.js

返回示例

错误码

HttpCode	错误码	错误信息	说明
400	user.not.exist	user not exist	用户在当前企业中不存在
400	org.not.exist	org not exist	当前企业在Teambition中不存在
500	server.error	system error	系统内部服务错误

这篇文档是否有帮助？

本页内容