更新自由任务状态新版SDK
更新于 2023-05-12
例如，员工小钉有个自由任务名为测试任务1，任务的状态为未完成，如下图所示。
任务状态更新为已完成后，该任务会从任务列表移除。
权限
要调用此API，需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
|---|---|---|---|
| 企业内部应用 | 支持 | 项目应用中任务写权限 | API Explorer |
| 第三方企业应用 | 支持 | 项目应用中任务写权限 | API Explorer |
| 第三方个人应用 | 暂不支持 | 项目应用中任务写权限 | 暂不支持 |
请求方法
Header参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证。
|
Path参数
Body参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
isDone | Boolean | 是 | 自由任务状态。
|
disableActivity | Boolean | 否 | 是否禁止动态。
|
disableNotification | Boolean | 否 | 是否禁止通知。
|
返回参数
名称 | 类型 | 描述 |
|---|---|---|
result | Object | 返回结果。 |
isDone | Boolean | 自由任务状态。
|
updateTime | String | 更新任务状态的时间，格式：YYYY-MM-DDTHH:mm:ssZ（ISO 8601/RFC 3339）。 说明
转换成北京时间，需要在参数时间基础上加8小时。例如参数值为2022-06-20T00:00:00Z，表示的北京时间为2022-06-20 08:00:00。 |
示例
请求示例
返回示例
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
400 | user.not.exist | user not exist | 用户在当前企业中不存在 |
400 | org.not.exist | org not exist | 当前企业在Teambition中不存在 |
500 | server.error | system error | 系统内部服务错误 |
