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. |