删除用户

DELETE

/open-apis/contact/v3/users/{user_id}

自建应用

该接口向通讯录删除一个用户信息，可以理解为员工离职。
若用户归属部门A、部门B，应用的通讯录权限范围必须包括部门A和部门B才可以删除用户。应用商店应用无权限调用接口。用户可以在删除员工时设置删除员工数据的接收者，如果不设置则由其leader接收，如果该员工没有leader，则会将该员工的数据删除。

错误码

HTTP状态码	错误码	描述	排查建议
400	40001	param error	参数错误。
403	40004	no dept authority error	操作的部门需在通讯录权限范围中，了解更多
403	41050	no user authority error	操作的用户需在通讯录权限范围中，了解更多
400	41052	user resign acceptor is invalid error	用户辞职审批人无效

请求示例

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://open.feishu.cn/open-apis/contact/v3/users/ou_7dab8a3d3cdcc9da365777c7ad535d62?user_id_type=open_id' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "department_chat_acceptor_user_id": "ou_7dab8a3d3cdcc9da365777c7ad535d62",
    "external_chat_acceptor_user_id": "ou_7dab8a3d3cdcc9da365777c7ad535d62",
    "docs_acceptor_user_id": "ou_7dab8a3d3cdcc9da365777c7ad535d62",
    "calendar_acceptor_user_id": "ou_7dab8a3d3cdcc9da365777c7ad535d62",
    "application_acceptor_user_id": "ou_7dab8a3d3cdcc9da365777c7ad535d62",
    "helpdesk_acceptor_user_id": "ou_7dab8a3d3cdcc9da365777c7ad535d62",
	"email_acceptor": {
		"processing_type": 1,
		"acceptor_user_id": "ou_7dab8a3d3cdcc9da365777c7ad535d62",
	}
}'

响应示例

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

请求参数

Path 参数

user_id

必需

用户ID，需要与查询参数中的user_id_type类型保持一致。示例值："ou_7dab8a3d3cdcc9da365777c7ad535d62"

示例值:

ou_7dab8a3d3cdcc9da365777c7ad535d62

Query 参数

user_id_type

必需

用户 ID 类型示例值："open_id"可选值有：open_id：用户的 open idunion_id：用户的 union iduser_id：用户的 user id默认值：open_id当值为 user_id，字段权限要求：perm获取用户 userid

示例值:

open_id

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

department_chat_acceptor_user_id

string

可选

部门群接收者。被删除用户为部门群群主时，转让群主给指定接收者，不指定接收者则默认转让给群内第一个入群的人示例值："ou_7dab8a3d3cdcc9da365777c7ad535d62"

external_chat_acceptor_user_id

string

可选

外部群接收者。被删除用户为外部群群主时，转让群主给指定接收者，不指定接收者则默认转让给群内与被删除用户在同一组织的第一个入群的人，如果组织内只有该用户在群里，则解散外部群示例值："ou_7dab8a3d3cdcc9da365777c7ad535d62"

docs_acceptor_user_id

string

可选

文档接收者。用户被删除时，其拥有的文档转让给接收者，不指定接收者则默认转让给直接领导，如果无直接领导则直接删除文档资源示例值："ou_7dab8a3d3cdcc9da365777c7ad535d62"

calendar_acceptor_user_id

string

可选

日程接收者。用户被删除时，其拥有的日程转让给接收者，不指定接收者则默认转让给直接领导，如果无直接领导则直接删除日程资源示例值："ou_7dab8a3d3cdcc9da365777c7ad535d62"

application_acceptor_user_id

string

可选

应用接收者。用户被删除时，其创建的应用转让给接收者，不指定接收者则默认转让给直接领导，如果无直接领导则不会转移应用，会造成应用不可用示例值："ou_7dab8a3d3cdcc9da365777c7ad535d62"

helpdesk_acceptor_user_id

string

可选

用户超文本帮助信息接收者示例值："ou_7dab8a3d3cdcc9da365777c7ad535d62"

minutes_acceptor_user_id

string

可选

妙记接收者。用户被删除时，其拥有的妙记资源转让给接收者。如果不指定接收者，则默认转让给直属上级。如果无直属上级则将妙记保留在该用户名下。示例值："ou_7dab8a3d3cdcc9da365777c7ad535d62"

survey_acceptor_user_id

string

可选

飞书问卷接收者。用户被删除时，其拥有的飞书问卷资源转让给接收者，不指定接收者则默认转让给直属上级，如果无直属上级则直接删除飞书问卷资源。示例值："ou_7dab8a3d3cdcc9da365777c7ad535d62"

email_acceptor

object

可选

用户邮件资源处理方式。用户被删除时，根据传递的操作指令对其拥有的邮件资源做对应处理。未传递指令时默认将邮件资源转让给直属上级，如果无直属上级则保留邮件资源在该用户名下。

processing_type

string

可选

邮件处理方式示例值："1" 可选值有： 1：转移资源 2：保留资源 3：删除资源

acceptor_user_id

string

可选

在 processing_type 为 1 （转移资源时），邮件资源接收者示例值："ou_7dab8a3d3cdcc9da365777c7ad535d62"

示例

返回响应

🟢200200 Success

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

创建用户

修改用户部分信息

删除用户

错误码#

请求参数

返回响应

错误码