Toolset employer_managers
Employer managers, settings, access and limits.
11 tools. Mutations require an explicit confirm=true argument; Auth marks tools that need an hh.ru token.
| Tool | Operation | Auth | Confirm | Description |
|---|---|---|---|---|
employer_create_manager |
POST /employers/{employer_id}/managers |
yes | yes | Add a manager to the employer. body is a JSON object per spec (emails, manager_type id from employer_list_manager_types, is_admin and other fields); returns 201 with the new manager id. |
employer_delete_manager |
DELETE /employers/{employer_id}/managers/{manager_id} |
yes | yes | Delete a manager; successor_id (required) receives the manager's vacancies, negotiations, folders, comments and saved searches. Deletion is asynchronous: the manager may appear in lists briefly. Returns 204 on success. |
employer_get_manager |
GET /employers/{employer_id}/managers/{manager_id} |
yes | – | Get full info about one manager of the employer. |
employer_get_manager_method_access |
GET /employers/{employer_id}/managers/{manager_id}/method_access |
yes | – | Paid-method access groups for the manager: resume viewing and negotiations, resume database search and saved searches, viewing responded and database-found resumes. |
employer_get_manager_resume_limits |
GET /employers/{employer_id}/managers/{manager_id}/limits/resume |
yes | – | Daily resume viewing limit for the manager (a manager may only view their own limit). |
employer_get_manager_settings |
GET /employers/{employer_id}/managers/{manager_id}/settings |
yes | – | Manager preferences (default vacancy template, vacancy type and similar prefill hints). Preferences do not change API behaviour by themselves – an app may use them for prefilling. |
employer_get_manager_vacancy_types |
GET /employers/{employer_id}/managers/{manager_id}/vacancies/available_types |
yes | – | All vacancy publication types available to the manager (whether the manager can publish and which types). Deprecated by hh.ru in favour of the vacancy services list (employer_misc toolset). |
employer_list_manager_types |
GET /employers/{employer_id}/manager_types |
yes | – | Dictionary of manager types with their permission sets – the manager_type ids for employer_create_manager and employer_update_manager. |
employer_list_managers |
GET /employers/{employer_id}/managers |
yes | – | List managers of the employer (paginated, per_page max 200); search_text filters by manager name. Manager ids are used by saved-search transfer, vacancy publishing and manager settings. |
employer_update_manager |
PUT /employers/{employer_id}/managers/{manager_id} |
yes | yes | Edit manager parameters: body carries the fields to change (emails, manager_type and others per spec). Returns 200 on success. |
get_my_manager_accounts |
GET /manager_accounts/mine |
yes | – | Work accounts of the current manager with main/current account markers. To act under a specific account, its account_id is passed in the X-Manager-Account-Id header (not set by this MCP server). |