撤销入职

通过本接口对指定待入职，入职准备就绪的员工执行撤销入职操作，对应入职管理页面撤销入职按钮

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v2/pre_hires/withdraw_onboarding
HTTP Method	POST
接口频率限制	100 次/分钟
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	corehr:pre_hire:withdraw_onboarding 撤销入职

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

请求体

名称	类型	必填	描述
pre_hire_id	string	是	待入职ID，可以通过搜索待入职人员信息接口获得 示例值："7345005664477775407"
withdraw_reason	string	是	撤销原因，上限为500字 示例值："候选人主动放弃入职"

请求体示例

{
    "pre_hire_id": "7345005664477775407",
    "withdraw_reason": "候选人主动放弃入职"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ success	boolean	是否成功撤销入职

响应体示例

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

错误码

HTTP状态码	错误码	描述	排查建议
400	1161116	A conflict occurred as multiple people are operating at the same time. Please refresh the page and try again later.	多人同时操作发生冲突，请稍后刷新页面后重试
400	1161097	Permission denied, please contact the administrator.	无权限操作，请联系管理员
400	1161105	You don't have the permission to view the prehire, or the prehire does not exist	无权限查看该待入职人员，或该待入职人员不存在
400	1161129	Unable to submit this task as pre-hire is in the "" stage.	该待入职人员当前状态为「」，无法进行此操作
400	1161094	Invalid workflow operation.	当前步骤不允许执行
400	1161001	param is invalid	请填写正确的参数
500	1161000	Server system error	系统出现问题，如需帮助，请咨询技术支持。
503	1161204	Requset timeout	请求超时，请稍后重试
429	1161604	QPS over limit	接口请求过多，请稍后重试