更新自由任务标题

PUT

/v1.0/project/organizations/users/{userId}/tasks/{taskId}/contents

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

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

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

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

权限

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

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

请求示例

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

curl --location --request PUT 'https://api.dingtalk.com/v1.0/project/organizations/users//tasks//contents' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "content" : "String",
  "disableActivity" : Boolean,
  "disableNotification" : Boolean
}'

响应示例

{
    "result": {
        "content": "string",
        "updated": "string"
    }
}

请求参数

Path 参数

userId

string

必需

操作者userId。

taskId

string

必需

任务id。

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

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

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。

企业内部应用，调用获取企业内部应用的accessToken接口获取。

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

Body 参数application/json

content

string

任务标题。

必需

示例

返回响应

🟢200成功

application/json

Body

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。

修改于超过 1 年前

批量获取自由任务详情

更新自由任务状态

更新自由任务标题

权限#

请求参数

返回响应

权限