API : Employee Upload Picture

This request is used to upload a picture of the employee. Supported formats are JPEG, PNG, WebP, TIFF, GIF and SVG.

The picture must be a photograph of one person. It is checked automatically on Telecom X's own servers - it is not sent to anyone else - and refused with 422 (check is one_person, see Errors) when it:

• is not a photograph, e.g. a drawing, cartoon, painting, logo or text (reason is not_photo),
• shows no face (no_face) or more than one face (people), or
• shows a child (child).

The reason tells the client why, and the message says it in words, e.g. “No face was found in the picture”. Without a known reason the message is “The picture must show one person”.

An accepted picture is cropped to a square around face and neck, its background is replaced with light grey, and it is stored as a JPEG of at most 1024×1024 pixels.

Employees that are not a person may have any picture: employees with access level NO_LOGIN whose master product gives extension access but no Communicator, recording or SIP phone access (e.g. a queue), and employees whose master product has “api” or “test” in its name. A photograph with one face is still cropped the same way.

If the check cannot be made, the picture is stored as uploaded.

The upload must be performed as a multipart/form-data post request.

https://api.telecomx.dk/employee/1234567890ABCDEF1234578/picture

{
  success: true,
  picture: '123456789012345678901234
}