Update a requisition
PATCH/v1/requisitions/:id
Updates a requisition. Fields not sent are unchanged. Closed, archived and filled requisitions can't be updated.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
Requisition updated
The requisition couldn't be updated. Error codes:
err_requisition_not_updatable- the requisition is closed, archived or fillederr_requisition_already_associated- the requisition is linked to an offer or hire, soapply_to_groupmust be trueerr_missing_permission_for_recruiter- the recruiter can't collaborate on requisitionserr_missing_permission_for_hiring_manager- the hiring manager can't collaborate on requisitionserr_job_is_closed_or_archived- the job is closed or archivederr_requisition_update_failed- the requisition couldn't be saved; the message gives the reason
Missing or invalid bearer token.
The public API is not enabled for this account (err_feature_not_enabled), the acting user is not allowed to manage this requisition, or the API key lacks the requisitions:write scope (err_insufficient_scope). Also returned when requisitions are not enabled for your account (err_requisition_feature_not_enabled). Changing confidential also needs permission to edit confidential requisitions (err_missing_permission_for_confidential).
The requisition, or a department, office, user, currency, job profile or job you sent, was not found. Error codes:
err_requisition_not_found- unknown requisitionerr_department_not_found- unknown departmenterr_office_not_found- unknown officeerr_recruiter_not_found- the recruiter is not an active user in the accounterr_hiring_manager_not_found- the hiring manager is not an active user in the accounterr_salary_currency_not_found- unknown salary currencyerr_equity_currency_not_found- unknown equity currencyerr_job_profile_not_found- unknown job profileerr_job_not_found- unknown job, or one you can't view
Validation failed. Error codes:
err_invalid_employment_type-employment_typeisn't a key from List all employment typeserr_requisition_not_eligible_for_reapproval- the requisition can't be sent for approval againerr_requisition_associated_with_job- the requisition is already linked to another joberr_<field>_required- a field the requisition form marks Mandatory is missing or set to null, e.g.err_hiring_manager_requiredorerr_job_required