alerts.calendars.read；新建、修改、删除和读文件需要 alerts.calendars.manage。每周时段怎么按日历算，见节假日日历。
新建或修改日历
POST 新建一份日历，PUT 整份替换。响应是这份日历，带 id、org_id、created_by、created_at 和 updated_at。
calendar 里写日历的 id 就能用它：{"calendar_id": "<id>", "holidays": "exclude"} 把放假的日子去掉，"holidays": "only" 只在放假的日子生效。升级策略的支持时段、路由规则和通知策略的时间条件、值班排班的轮值、告警流水线以及每周重复的静默窗口都能带它。保存时日历不在本组织里会返回 400。
读 ICS 文件
POST /parse 接受 {"content": "<.ics 的内容>"}，最大 2 MiB，返回 {"days": [...]}，什么都不保存：每个全天事件算一天，跨几天的事件每天各算一天，名称含「补班」「上班」或以「班」结尾的算 workday。
查看哪些地方在用
GET /{id}/references 列出按这份日历算的地方，每项是 {"kind", "id", "name"}；kind 为 routing_rule、escalation_policy、schedule、mute_rule、notify_policy 或 alert_pipeline。列表不为空时 DELETE 返回 409。
错误