update_requisition
Updates an existing requisition. Changes are applied to specified fields; omitted custom fields are cleared. Cannot modify requisitions with closed, archived, or filled statuses.
Instructions
Update an existing requisition. Cannot modify requisitions with closed, archived, or filled statuses. Pass all custom field values in additional_info — omitted fields will be cleared.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Requisition ID | |
| role_name | No | Job role name for this requisition | |
| employment_type | No | Employment type (full_time, part_time, contract, internship, temporary, seasonal) | |
| requisition_type | No | Requisition type (new_hire, contract, backfill, internship, internal) | |
| department_id | No | Department ID | |
| office_ids | No | Comma-separated office IDs (at least one required) | |
| description | No | Requisition description | |
| minimum_salary | No | Minimum salary amount | |
| maximum_salary | No | Maximum salary amount | |
| salary_currency_id | No | Currency country ID for salary | |
| recruiter_id | No | User ID of the assigned recruiter | |
| hiring_manager_id | No | User ID of the hiring manager | |
| target_hire_date | No | Target hire date (YYYY-MM-DD) | |
| target_start_date | No | Target start date (YYYY-MM-DD, must be on or after target_hire_date) | |
| confidential | No | Whether this requisition is confidential | |
| job_id | No | Associate a job or change the associated job. Set to null to remove association. | |
| additional_info | No | Custom field values as key-value pairs. Pass all values — omitted fields will be cleared. | |
| apply_to_group | No | When true, updates all requisitions in the group. Defaults to false (requisition leaves the group). | |
| reapproval_note | No | Note included if approval workflows trigger reapproval |