Skip to content

Toolset employer_vacancies

Employer vacancy CRUD, drafts, publication, stats.

23 tools. Mutations require an explicit confirm=true argument; Auth marks tools that need an hh.ru token.

Tool Operation Auth Confirm Description
employer_archive_vacancy PUT /employers/{employer_id}/vacancies/archived/{vacancy_id} yes yes Move a published vacancy to the archive. Mutation: requires confirm=True.
employer_create_vacancy POST /vacancies yes yes Publish a new vacancy on behalf of the employer. The vacancy object goes into the body parameter. Mutation: requires confirm=True.
employer_create_vacancy_draft POST /vacancies/drafts yes yes Create a vacancy draft (published later with employer_publish_vacancy_draft). Mutation: requires confirm=True.
employer_delete_auto_publication DELETE /vacancies/auto_publication yes yes Cancel the scheduled automatic publication of a draft. Mutation: requires confirm=True.
employer_delete_vacancy_draft DELETE /vacancies/drafts/{draft_id} yes yes Delete a vacancy draft. Mutation: requires confirm=True.
employer_get_preferred_negotiations_order GET /vacancies/{id}/preferred_negotiations_order yes – Get the preferred sorting order of responses (negotiations) for the vacancy.
employer_get_prolongate_info GET /vacancies/{vacancy_id}/prolongate yes – Get information about prolonging a vacancy: possible terms and their cost before actually prolonging.
employer_get_vacancy_draft GET /vacancies/drafts/{draft_id} yes – Get one vacancy draft by its id.
employer_get_vacancy_stats GET /vacancies/{vacancy_id}/stats yes – Get statistics of a published vacancy: views, responses and other counters.
employer_get_vacancy_upgrades GET /vacancies/{vacancy_id}/upgrades yes – List paid upgrades (promotion options) available for the vacancy.
employer_get_vacancy_visitors GET /vacancies/{vacancy_id}/visitors yes – Get candidates who viewed the vacancy, with pagination.
employer_hide_vacancy PUT /employers/{employer_id}/vacancies/hidden/{vacancy_id} yes yes Hide (soft-delete) a vacancy: it leaves the search but can be restored. Mutation: requires confirm=True.
employer_list_active_vacancies GET /employers/{employer_id}/vacancies/active yes – List active (published) vacancies of the employer with filters by manager, region, text and pagination.
employer_list_archived_vacancies GET /employers/{employer_id}/vacancies/archived yes – List archived vacancies of the employer with manager filter, ordering and pagination.
employer_list_draft_duplicates GET /vacancies/drafts/{draft_id}/duplicates yes – Check the draft for duplicates among active vacancies of the employer before publishing.
employer_list_hidden_vacancies GET /employers/{employer_id}/vacancies/hidden yes – List hidden (deleted) vacancies of the employer; they can be restored with employer_unhide_vacancy.
employer_list_vacancy_drafts GET /vacancies/drafts yes – List vacancy drafts of the current employer with pagination.
employer_prolongate_vacancy POST /vacancies/{vacancy_id}/prolongate yes yes Prolong a published vacancy by publication_period days. Mutation: requires confirm=True.
employer_publish_vacancy_draft POST /vacancies/drafts/{draft_id}/publish yes yes Publish the vacancy stored in the draft. Mutation: requires confirm=True.
employer_set_preferred_negotiations_order PUT /vacancies/{id}/preferred_negotiations_order yes yes Set the preferred sorting order of responses for the vacancy: body like {"order": "last_change_time"} (sent form-encoded). Mutation: requires confirm=True.
employer_unhide_vacancy DELETE /employers/{employer_id}/vacancies/hidden/{vacancy_id} yes yes Restore a previously hidden vacancy from the deleted list. Mutation: requires confirm=True.
employer_update_vacancy PUT /vacancies/{vacancy_id} yes yes Edit a published vacancy: the full edited vacancy object goes into body. Mutation: requires confirm=True.
employer_update_vacancy_draft PUT /vacancies/drafts/{draft_id} yes yes Edit a vacancy draft: the edited draft fields go into body. Mutation: requires confirm=True.