Upload the profile picture (avatar) of an employee
Uploads and replaces the employee’s profile picture.
Accepted formats: image/png and image/jpeg only. Any other content type (webp, heic, gif, svg, …) is rejected with 422 invalid_image_type.
Maximum size: 5 MB. Larger files are rejected with 422 file_too_large.
Resulting resolution: the image is resized server-side so that its longest side is at most 500 px, keeping the aspect ratio; images smaller than that are not scaled up. The stored file is re-encoded as JPEG regardless of the uploaded format.
Uploading a new picture replaces the previous one and deletes the previous file from storage. Each upload produces a new URL, so a client can detect changes by comparing the returned imageProfileURL with the one it stored previously.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Employee ID
Body
The image file to store as the employee's profile picture
PNG or JPEG file, up to 5 MB
Response
The profile picture was stored and the new public URL is returned