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