API Versions and Changelog

API Versions

Use this section to publish:

Skailer is now available as an MCP server for AI assistants: add it from the Claude connector directory, or connect any MCP client manually at https://mcp.skailer.com/mcp.
Covers employee search, goals and OKR (including key results and check-ins), and time off (requests, balance, calendar, categories).
Access goes through OAuth and is limited by the authorizing user’s permissions. See MCP Connector.

POST /api/v1/employees/{employee_id}/compensations/search now returns lines - base salary, allowances, deductions, and employer contributions of each compensation version.
Additional compensations are one-time payments only; recurring ones are package lines.
Added GET /api/v1/calendar-holidays, POST /api/v1/calendar-holidays/dates/search and POST /api/v1/calendar-holidays/employees/search - holiday calendars, their dates, and the calendar of each employee.
Added GET /api/v1/custom-fields/fields - employee custom fields with their options.

Added GET /api/v1/applicant-labels/all - applicant labels of the organization, for use with the label_ids filter of applicant search.
Added GET /api/v1/candidates/{candidate_id}/feedbacks - scorecard feedbacks of a candidate with every question, its answer text, interviewer comment, and selected scale or select options.
Added GET /api/v1/candidates/{candidate_id}/feedbacks/overview - aggregated scorecard stats of a candidate without the answer texts.
Added POST /api/v1/time-off/availability/search - the dates employees are on time off within a period, each with its category.
POST /api/v1/time-off/logs/search now accepts the optional date_from and date_to period filter.

Added the /api/v1/documents endpoint group: folders by type, employee folders, document search, upload, download, rename, and delete.
Documents now return employee_id - the employee the document belongs to, or null for an organization document.
ATS and audit log endpoint descriptions are now in English (permissions unchanged).

Added POST /api/v1/job-catalog/profiles/search - job profiles with role, level (nested track and grade), salary, and legacy_pairs for mapping old position/level ids.
Added GET /api/v1/organization-lists/type/{list_type} to get an organization list by type with its items.

Jobs search now returns career_site_ids for each job.
Added PUT /api/v1/jobs/{id} to edit jobs (mirrors create, with file_ids/uuid backward compatibility).
Added GET /api/v1/career-sites/all to list all organization career sites with settings and contacts.

Added methods for full employee synchronization: create/update/archive, CRUD for positions, employments, compensations, additional compensations, and custom table rows.
Added organization custom tables API: list tables and search rows.
Added time-off API: categories, employee leave history, and balance on a date.