更新自由任务标题

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
第三方个人应用	暂不支持	项目应用中任务写权限	暂不支持

请求参数

Path 参数

Header 参数

Body 参数application/json

示例

{
  "content" : "String",
  "disableActivity" : Boolean,
  "disableNotification" : Boolean
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT '/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
}'

返回响应

🟢200成功

application/json

Body

示例

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

修改于 2025-09-08 06:28:05

批量获取自由任务详情

更新自由任务状态

更新自由任务标题

权限#

请求参数

请求示例代码

返回响应

权限