删除成员
成员管理
删除成员
通过 ID、邮箱、手机号或名称从组织中移除成员。
POST
删除成员
限制说明
使用说明
- 默认情况下(
is_force=false),系统会检查该成员是否被其他资源引用(如分派策略、值班表等)。如果存在引用,接口将返回错误码ReferenceExist并在data.refs中返回引用列表。设置is_force=true可跳过引用检查,直接强制删除。 - 通过 SSO 同步且 SSO 配置了成员不可编辑(
sso_user_non_editable=true)的成员,无法通过此接口删除。需要先在 SSO 配置中关闭该限制。 - 此操作会记录审计日志。
授权
在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。
请求体
application/json
删除成员请求(提供其中一个查找字段)
成员 ID。同时提供多个查找字段时,按 member_id > member_name > email > phone > ref_id 的优先级取第一个非空值
成员名称。仅在未提供 member_id 时生效
邮箱地址。仅在 member_id、member_name 均未提供时生效
手机号。仅在 member_id、member_name、email 均未提供时生效
当 phone 不带 "+" 前缀时的解析地区提示 —— ISO 3166-1 alpha-2 地区代码(如 "CN",未传时默认 "CN")。此解析场景仍兼容 "86" 等数字电话区号。
外部引用 ID。仅在其他查找字段均未提供时生效
是否强制删除。默认 false,会检查成员是否被分派策略、值班表等资源引用;设为 true 则跳过引用检查直接删除