删除日程

调用该接口以当前身份（应用或用户）删除指定日历上的一个日程。

Tip: - 当前身份由 Header Authorization 的 Token 类型决定。tenant_access_token 指应用身份，user_access_token 指用户身份。

• 如果使用应用身份调用该接口，则需要确保应用开启了机器人能力。
• 当前身份必须对日历有 writer 或 owner 权限，并且日历的类型只能为 primary 或 shared。你可以调用查询日历信息接口，获取日历类型以及当前身份对该日历的访问权限。
• 当前身份必须是日程的组织者。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/calendar/v4/calendars/:calendar_id/events/:event_id
HTTP Method	DELETE
接口频率限制	1000 次/分钟、50 次/秒
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	calendar:calendar 更新日历及日程信息 calendar:calendar.event:delete 删除日程

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token

路径参数

名称	类型	描述
calendar_id	string	日程所在的日历 ID。了解更多，参见日历 ID 说明。 示例值："feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn"
event_id	string	日程 ID。获取方式： - 创建日程会返回日程 ID - 获取日程列表 - 搜索日程 示例值："xxxxxxxxx_0"

查询参数

名称	类型	必填	描述
need_notification	string	否	删除日程是否给日程参与人发送 Bot 通知。 默认值：true 示例值：false 可选值有： - true: 发送 - false: 不发送

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {}
}

错误码

HTTP状态码	错误码	描述	排查建议
400	190002	invalid parameters in request	无效的请求参数。排查建议如下： - 确认请求参数的字段名称、传参类型正确。 - 确认已经申请了相应资源的权限。 - 确认相应资源未被删除。
500	190003	internal service error	内部服务错误，请咨询技术支持。
429	190004	method rate limited	方法频率限制。建议稍后再试，并适当减小请求 QPS。
429	190005	app rate limited	应用频率限制。建议稍后再试，并适当减小请求 QPS。
403	190006	wrong unit for app tenant	请求错误，检查应用 App ID 和 App Secret 是否正确。如仍无法解决请咨询技术支持。
404	190007	app bot_id not found	应用的 bot_id 没有找到。你需要确保应用开启了机器人能力。如仍未解决请咨询技术支持。
429	190010	current operation rate limited	当前操作被限流，原因一般为公用资源并发抢占失败。你可以适当降低当前操作频率，然后重试。
404	191000	calendar not found	日历没有找到。你需要检查并改为正确的日历 ID。
400	191001	invalid calendar_id	calendar_id 无效。你需要检查并改为正确的日历 ID。
403	191002	no calendar access_role	当前身份没有日历的访问权限。如需查询某一日历信息，则需要确保当前身份拥有该日历的访问权限。
403	191003	calendar is deleted	日历已经被删除。你需要检查并改为正确的日历 ID。
403	191004	invalid calendar type	日历类型错误。你可以调用查询日历信息接口获取日历类型信息，然后确保日历类型适用于当前接口。
400	193000	invalid event_id	event_id 无效。你需要检查并改为正确的日程 ID。
404	193001	event not found	日程未找到。你需要确保传入了正确的日程 ID。
403	193002	no permission to operate event	无权限操作。你需要确保有日历以及日程的编辑权限。
403	193003	event is deleted	日程已经被删除。你需要检查并改为正确的日程 ID。日程获取方式： - 创建日程会返回日程 ID - 获取日程列表 - 搜索日程
404	195100	user is dismiss or not exist in the tenant	当前身份或指定用户已经离职，或者不在该租户内。请检查并改为正确的身份来调用接口。

更多错误码信息，参见通用错误码。