Uploads a new photo for an employee. The request must be a multipart/form-data POST with a file field. Confirmed supported formats: JPEG, PNG, BMP. Other formats (e.g. HEIC, SVG, AVIF, TIFF) are not reliably supported and may return 415, 500, or 502. The image must be square (width and height must match within one pixel) and at least 150×150 pixels. Maximum file size is 20MB. The photo replaces the employee's current photo for all size variants. Employees may upload their own photo if the company has self-photo uploads enabled.
The photo was uploaded and processed successfully.
The request is invalid: no file provided, zero-byte file, or the maximum number of photo uploads (32767) has been exceeded.
The API user does not have permission to upload photos for this employee.
The employee does not exist.
The uploaded file exceeds the 20MB size limit.
The image does not meet requirements: not square (width and height differ by more than one pixel), smaller than 150×150 pixels, or the file could not be read as a supported image format.