improved

Documents API: Upload endpoint has a 30MB file size limit

The Public API endpoint for uploading Documents (POST /company/documents) will accept documents of size 30 MB or lesser, in accordance with the Documents product.

improved

Employee API: added supervisor_id field

Added the feature to set/update Employee's Supervisors.

improved

Employee API: added status field

Added the feature to set/update Employee's Status.

added

Added Custom Reports Public API Endpoints

Three new endpoints were added to the Personio API around retrieving Custom Reports. After users have created a Custom Report in the Personio web app, the endpoints allow them to pull the data contained within this report in JSON format:

added

Absences API : Endpoint for fetching hourly absences added

In Personio, it was already possible to fetch daily absence periods. We've added a new endpoint that allows customers to fetch hourly periods, along with daily breakdowns for those periods.

improved

Employees API: Currency is now exposed

In Personio, it is already possible to retrieve salary data for employees. That salary data currently does not include the currency of a particular employee’s salary. From now on we are adding the currency attribute to the salary model in the employee endpoint.

added

Documents API: Post documents endpoints

Two new endpoints were added to the Personio public API.

improved

Employee API: renamed the /custom-attributes endpoint with backward compatibility

The endpoint GET v1/employees/custom-attributes was originally created to support custom attributes only.
It evolved to more than that and now also returns information about regular attributes. To ensure correct naming we are renaming it to GET v1/employees/attributes.
Both endpoints will remain available to ensure compatibility.

improved

Employees API: Universal ID is now exposed

The employee object now has the Universal ID (UID) exposed.

improved

Attendances API: added optional "skip_approval" parameter

Attendances periods created via the POST /company/attendances, the updates via PATCH company/attendances and deletions via DELETE company/attendances endpoints used to skip the approval process by default, so there was no way to create attendances requests using the public API.