修改日程参与者旧版SDK
更新于 2024-01-11
为提升接口的使用体验，提供更加规范的接口，钉钉针对日程相关接口进行了升级。本接口文档已于2021年11月09日迁移至历史文档（不推荐）目录下，接口不会下线。
新版和旧版日程API的ID体系不同，不能混合使用，推荐使用新版日程接口。
已接入的用户建议您根据自身实际情况评估是否切换至新接口。
新接入的用户建议直接使用新接口修改日程参与者。
本接口使用说明：
只能修改通过创建日程接口创建的日程。
确保已经申请了修改并查询日程接口权限。
权限
服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。详情请参考。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
企业内部应用 | 是 | 重要 暂不支持新增申请。 | — |
第三方企业应用 | 否 | — | — |
第三方个人应用 | 否 | — | — |
基本信息
请求方式：POST
请求地址：https://oapi.dingtalk.com/topapi/calendar/v2/attendee/update
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | 6d1bxxxx | 调用服务端API的应用凭证。
|
Body参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
calendar_id | String | 是 | primary | 日历ID。 目前仅支持传primary表示修改当前用户“我的日程”下的日程。 |
event_id | String | 是 | 053Exxxx | 加密后的日程ID。 |
attendees | Attendee[] | 是 | 参与者列表。 | |
attendee_status | String | 是 | add | 添加或者删除状态：
|
userid | String | 是 | user123 | 日程参与者userid。 |
agentid | Number | 否 | 1212 | 应用对应的AgentId。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
success | Boolean | true | 是否成功。 |
errcode | Number | 0 | 返回码。 |
errmsg | String | ok | 返回码说明。 |
request_id | String | zbbs6uxpei1r | 请求ID。 |
示例
请求示例（HTTP）
请求正文
请求示例（JAVA SDK）
返回示例
