Update Employee Record

Update an existing employee record, including contact information and shipping addresses.

Updates made via this API are automatically reflected in the Locations app, Manage app → Users view, and the Shipping Address selector in Unduit's order workflows. This enables seamless integration between your internal HR/location systems and Unduit's IT Asset Management platform.

PUT

/api/v1/employee/update/{id}

Description

Use the PUT Employee Record endpoint to update an existing employee record with contact information and shipping addresses. You must send the full set of required fields in the request body (this is not a partial update). The record must belong to your organization and must not be deleted.

Request

Headers

Header	Value	Required
Authorization	Bearer <access_token>	Yes
Content-Type	application/json	Yes

Path Parameters

Parameter	Type	Required	Description
id	String	Yes	Employee/address identifier. Use the `address.id` from the Create Employee response. URL-encode the value when it contains special characters.

Request Body (JSON)

Field	Type	Required	Description	Validation Rules
firstname	String	Yes	First name of the user	Must not be empty, letters and spaces only
lastname	String	Yes	Last name of the user	Must not be empty, letters and spaces only
location_name	String	Yes	Name of the associated location	Must not be empty
location_type	String	Yes	Type of location	Must be: Warehouse, Corporate Office, Retail Store, or Remote Employee
contact_info	Number	Yes	Phone number for contact	Must contain only numbers
email	String	Yes	Email address of the contact	Must be valid email format and not empty
address_1	String	Yes	Address line 1	Must not be empty
address_2	String	No	Address line 2 (suite, apt, etc.)	Optional
city	String	Yes	City name	Must not be empty
state	String	Yes	State or province	Must not be empty
zip	String	Yes	Zip or postal code	Must not be empty
country	String	Yes	Country code (ISO 3166-1 alpha-2)	Valid ISO 3166-1 alpha-2 code (e.g., US, GB)
contact_country	String	Yes	Country code of contact's location	Must not be empty

Response

Response Fields

Field	Type	Description
message	string	Status message confirming successful update
address	object	The updated employee record with all fields
address.id	number	Unique identifier for the employee record
address.firstname	string	Employee's first name
address.lastname	string	Employee's last name
address.email	string	Employee's email address
address.location_name	string	Name of the associated location
address.location_type	string	Type of location (Warehouse, Corporate Office, etc.)
address.contact_info	string	Phone number
address.company_id	number	Company identifier
address.created_at	string	Timestamp when record was created
address.updated_at	string	Timestamp of last update

Notes

This endpoint requires valid authentication. Include your access token in the Authorization header.
Use the address.id from a Create Employee response as the path id. URL-encode the value when required.
All required fields must be provided in the request body. Missing or invalid fields return a validation error.
The location_type field must be one of the following: Warehouse, Corporate Office, Retail Store, or Remote Employee.
Country codes must follow the ISO 3166-1 alpha-2 standard (e.g., US for United States, GB for United Kingdom).
Updated employee records are immediately available across all Unduit apps.

Related Endpoints

Create Employee Record

Add a new employee with contact and location information

Employee Directory

Retrieve a paginated list of all employees

Did this page help you?

Update Employee Record

Description

Request

Headers

Path Parameters

Request Body (JSON)

Response

Response Fields

Notes

Related Endpoints

Create Employee Record

Employee Directory

Request

Success Response (200)