Upload Employee Photo

Uploads a new photo for an employee. Accepts either a multipart/form-data POST with a file field carrying raw binary image bytes (typical browser/SDK usage), or an application/json POST with a fileBase64 property carrying the base64-encoded image bytes (typical MCP/LLM-connector usage). The server selects the path based on the request Content-Type. Supported formats: JPEG, PNG, BMP, GIF. Other formats (HEIC, SVG, AVIF, WebP) are rejected with 415; TIFF is accepted by the format gate but some variants may fail downstream. The image must be square (width and height must match within one pixel) and at least 150×150 pixels. Maximum file size is 20MB (applies to the decoded bytes for the JSON variant). 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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The ID of the employee whose photo is being uploaded.

Body Params
string
required

Base64-encoded image bytes. Same format/size/dimension rules as the multipart file field: JPEG, PNG, BMP, or GIF (HEIC, SVG, AVIF, and WebP are rejected with 415; TIFF is accepted by the format gate but some variants may fail downstream); square within 1 pixel; at least 150×150 pixels; decoded payload no larger than 20MB. Whitespace inside the base64 string is tolerated and stripped before decoding.

Headers
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses
201

The photo was uploaded and processed successfully. No response body is returned.

400

The request is invalid: no file provided, zero-byte file, or the maximum number of photo uploads (32767) has been exceeded.

402

The photo could not be processed: the image crop failed, or the file contents could not be read.

403

The authenticated user does not have permission to upload photos for this employee.

404

The employee does not exist.

413

The uploaded file exceeds the 20MB size limit.

415

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.

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!