更新招聘需求

更新指定招聘需求的信息，包含招聘需求的名称、状态、需求人数等。（审批中的招聘需求无法更新）

Warning: - 除文档中描述的必填字段（name、display_progress、head_count）外，其他字段是否必填请参考「飞书招聘」-「设置」-「招聘需求字段管理」

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/hire/v1/job_requirements/:job_requirement_id
HTTP Method	PUT
接口频率限制	5 次/秒
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	hire:job_requirement 更新招聘需求信息
字段权限要求	> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 contact:user.employee_id:readonly 获取用户 user ID

请求头

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

路径参数

名称	类型	描述
job_requirement_id	string	招聘需求ID，可通过获取招聘需求列表获取 示例值："6949805467799537964"

查询参数

名称	类型	必填	描述
user_id_type	string	否	用户 ID 类型 示例值：open_id 可选值有： - open_id: 标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID - union_id: 标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ - user_id: 标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？ 默认值：open_id 当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID
department_id_type	string	否	指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见部门ID说明。 示例值：department_id 可选值有： - open_department_id: 由系统自动生成的部门 ID，ID 前缀固定为 od-，在租户内全局唯一。 - department_id: 支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内 department_id 具有唯一性。 默认值：open_department_id
job_level_id_type	string	否	此次调用中使用的「职级 ID」的类型 示例值：job_level_id 可选值有： - people_admin_job_level_id: 「人力系统管理后台」适用的职级 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - job_level_id: 「飞书管理后台」适用的职级 ID，可通过获取租户职级列表获取 默认值：people_admin_job_level_id
job_family_id_type	string	否	此次调用中使用的「序列 ID」的类型 示例值：job_family_id 可选值有： - people_admin_job_category_id: 「人力系统管理后台」适用的序列 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - job_family_id: 「飞书管理后台」适用的序列 ID，可通过获取租户序列列表获取 默认值：people_admin_job_category_id
employee_type_id_type	string	否	此次调用中使用的「人员类型 ID」的类型 示例值：employee_type_enum_id 可选值有： - people_admin_employee_type_id: 「人力系统管理后台」适用的人员类型 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - employee_type_enum_id: 「飞书管理后台」适用的人员类型 ID，可通过查询人员类型获取 默认值：people_admin_employee_type_id

请求体

名称	类型	必填	描述
name	string	是	需求名称 示例值："HR部门春季招聘需求"
display_progress	int	是	需求状态 示例值：1 可选值有： - 1: 待启动 - 2: 进行中 - 3: 已取消 - 4: 已暂停 - 5: 已完成 - 6: 已超期
head_count	int	是	需求人数 示例值：11
recruitment_type_id	string	否	职位性质 ID，可在枚举常量介绍查阅枚举值。 - 注意：该字段即将下线，请使用「employee_type_id」字段。与「employee_type_id」字段必填其一 示例值："101"
employee_type_id	string	否	人员类型ID，类型需与employee_type_id_type保持一致 示例值："6807409776231254285"
max_level_id	string	否	最高职级 ID，需与job_level_id_type类型保持一致 示例值："6807409776231254286"
min_level_id	string	否	最低职级 ID，需与job_level_id_type类型保持一致 示例值："6807409776231254287"
sequence_id	string	否	职位序列 ID，需与job_family_id_type类型保持一致 示例值："6911957338526091536"
category	int	否	需求类型 示例值：1 可选值有： - 1: 新增 - 2: 替换
department_id	string	否	需求部门ID，需与department_id_type类型一致 示例值："od-4e6ac4d14bcd5071a37a39de902c7141"
recruiter_id_list	string\[\]	否	需求负责人 ID 列表，需与user_id_type类型保持一致 示例值：["od-4e6ac4d14bcd5071a37a39de902c7141"]
jr_hiring_manager_id_list	string\[\]	否	需求用人经理 ID 列表，需与user_id_type类型保持一致 示例值：["ou_0c9b1b7b9b94146b9df142c349e3c4bf"]
direct_leader_id_list	string\[\]	否	直属上级 ID，需与user_id_type类型保持一致 示例值：["od-4e6ac4d14bcd5071a37a39de902c7141"]
start_time	string	否	开始日期，毫秒时间戳 示例值："1625729379000"
deadline	string	否	预计完成日期，毫秒时间戳 示例值："1625729379000"
priority	int	否	招聘优先级 示例值：1 可选值有： - 1: 高 - 2: 中 - 3: 低
required_degree	int	否	学历要求 示例值：1 可选值有： - 1: 小学及以上 - 2: 初中及以上 - 3: 专职及以上 - 4: 高中及以上 - 5: 大专及以上 - 6: 本科及以上 - 7: 硕士及以上 - 8: 博士及以上 - 20: 不限
max_salary	string	否	月薪范围-最高薪资，单位：K 示例值："10"
min_salary	string	否	月薪范围-最低薪资，单位：K 示例值："5"
address_id	string	否	工作地点 ID，可通过获取地址列表获取 示例值："7265901641899311105"
description	string	否	需求描述 示例值："部门人力紧缺，需要招聘资深工程师10名"
customized_data_list	job_requirement_customized_data\[\]	否	自定义字段，可通过获取招聘需求模板获取，自定义字段是否必填需依据需求模板中自定义字段的定义。 - 注意： 更新时会全量覆盖
└ object_id	string	否	自定义字段 ID，可通过获取招聘需求模板获取 示例值："1213213123123"
└ value	string	否	自定义字段 value - 单选："1" - 多选："[\"1\", \"2\"]" - 单行："单行文本" - 多行："多行文本" - 数字："1" - 月份选择："1627379423000" - 年份选择："1627379423000" - 日期选择："1627379423000" - 时间段："[\"1577808000000\", \"1612108800000\"]" 示例值："简单文本"
process_type	int	否	招聘类型 示例值：1 可选值有： - 1: 社招 - 2: 校招
job_type_id	string	否	职位类别，可通过获取职位类别列表获取 示例值："6930815272790114324"
job_id_list	string\[\]	否	关联的职位 ID 列表（与 update_option. need_update_related_job 配合使用） 示例值：["6930815272790114324"] 数据校验规则： - 最大长度：200
employment_job_id	string	否	职务 ID，可通过获取租户职务列表获取（仅限飞书人事租户使用） 示例值："6807407987381831949"
position_id	string	否	岗位 ID，可通过查询岗位信息获取（仅限飞书人事租户使用，若链接无法打开，则说明飞书人事未启用岗位，请联系技术支持开通） 示例值："7094136522860922111"
update_option	job_requirement_update_option	否	招聘需求修改确认控制
└ need_update_related_job	boolean	否	是否需要修改关联的职位 示例值：false 默认值：false

请求体示例

{
    "name": "HR部门春季招聘需求",
    "display_progress": 1,
    "head_count": 11,
    "recruitment_type_id": "101",
    "employee_type_id": "6807409776231254285",
    "max_level_id": "6807409776231254286",
    "min_level_id": "6807409776231254287",
    "sequence_id": "6911957338526091536",
    "category": 1,
    "department_id": "od-4e6ac4d14bcd5071a37a39de902c7141",
    "recruiter_id_list": [
        "od-4e6ac4d14bcd5071a37a39de902c7141"
    ],
    "jr_hiring_manager_id_list": [
        "ou_0c9b1b7b9b94146b9df142c349e3c4bf"
    ],
    "direct_leader_id_list": [
        "od-4e6ac4d14bcd5071a37a39de902c7141"
    ],
    "start_time": "1625729379000",
    "deadline": "1625729379000",
    "priority": 1,
    "required_degree": 1,
    "max_salary": "10",
    "min_salary": "5",
    "address_id": "7265901641899311105",
    "description": "部门人力紧缺，需要招聘资深工程师10名",
    "customized_data_list": [
        {
            "object_id": "1213213123123",
            "value": "简单文本"
        }
    ],
    "process_type": 1,
    "job_type_id": "6930815272790114324",
    "job_id_list": [
        "6930815272790114324"
    ],
    "employment_job_id": "6807407987381831949",
    "position_id": "7094136522860922111",
    "update_option": {
        "need_update_related_job": false
    }
}

响应

响应体

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

响应体示例

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

错误码

HTTP状态码	错误码	描述	排查建议
500	1002001	系统错误	请根据实际报错信息定位或咨询技术支持
400	1002002	参数错误	检查参数是否正确，例如类型，大小
400	1002705	已启用招聘需求审批，不可通过API 新建、编辑招聘需求	开启招聘需求审批功能后，暂不支持通过API新建、编辑招聘需求。是否开启审批功能，请参考「飞书招聘」-「设置」-「招聘需求管理」-「招聘需求设置」下的「招聘需求审批」配置
400	1002708	人员类型不存在	请检查recruitment_type_id 或者employee_type_id参数
400	1002710	招聘需求职级已停用	请检查min_level_id或max_level_id参数
400	1002721	需求负责人存在重复、需求用人经理存在重复、或直属上级存在重复	请检查recruiter_id_list、jr_hiring_manager_id_list或direct_leader_id_list参数
400	1002722	「当前招聘需求人数」或「编制关联的所有招聘需求人数」超出空缺编制数，无法创建（该错误码仅对招聘人事一体化客户有效，如客户在编制侧开启创建招聘需求时需校验是否超编，则可能返回此错误码）	请比对需求人数与当前编制空缺数
400	1002723	未填写编制校验的必须内容	请按照编制校验要求，传入需要校验的字段内容
400	1002701	【通过 API 新建、编辑、删除招聘需求】开关未开启	请在「飞书招聘」-「设置」-「招聘需求管理」-「招聘需求设置」当中，开启【通过 API 新建、编辑、删除招聘需求】开关
400	1002702	企业开启了招聘需求审批，需求通过审批前无法关联职位。	/-
400	1002703	企业开启了招聘需求审批，审批中的招聘需求无法更新。	/-