---
title: "Replaces the Employee resource."
method: PUT
path: "/employees/{id}"
tags: ["Employee"]
---

# Replaces the Employee resource.

`PUT /employees/{id}`

Replaces the Employee resource.

## Path parameters

- `id` string, required

## Request body

- Employee — Someone working for this organization.
  - `id` string
  - `integration` string — The key of the integration source e.g. "quickbooks", or "xero"
  - `srcId` string
  - `firstName` string, nullable — First name of employee
  - `lastName` string, nullable — Last name of employee
  - `fullName` string, nullable
  - `active` boolean
  - `primaryPhone` string, nullable
  - `primaryAddr` string, nullable
  - `primaryAddrCity` string, nullable
  - `primaryAddrPostalcode` string, nullable
  - `primaryAddrState` string, nullable
  - `created` string, date-time, nullable
  - `modified` string, date-time, nullable
  - `link` string, nullable — Link to an external resource of the employee
  - `email` string, nullable
  - `mobilePhone` string, nullable
  - `payRate` string, nullable
  - `title` string, nullable
  - `gender` string, nullable
  - `birthDate` string, date-time, nullable
  - `hiredDate` string, date-time, nullable
  - `employeeNumber` string, nullable

## Response `200`

Employee resource updated

- Employee — Someone working for this organization.
  - `id` string
  - `integration` string — The key of the integration source e.g. "quickbooks", or "xero"
  - `srcId` string
  - `firstName` string, nullable — First name of employee
  - `lastName` string, nullable — Last name of employee
  - `fullName` string, nullable
  - `active` boolean
  - `primaryPhone` string, nullable
  - `primaryAddr` string, nullable
  - `primaryAddrCity` string, nullable
  - `primaryAddrPostalcode` string, nullable
  - `primaryAddrState` string, nullable
  - `created` string, date-time, nullable
  - `modified` string, date-time, nullable
  - `link` string, nullable — Link to an external resource of the employee
  - `email` string, nullable
  - `mobilePhone` string, nullable
  - `payRate` string, nullable
  - `title` string, nullable
  - `gender` string, nullable
  - `birthDate` string, date-time, nullable
  - `hiredDate` string, date-time, nullable
  - `employeeNumber` string, nullable

## Other responses

- `400` — Invalid input
- `404` — Resource not found
- `422` — Unprocessable entity

---

[API](https://skmtc.net/bossinsights/apis/boss-insights.md) · [All operations](https://skmtc.net/bossinsights/apis/boss-insights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bossinsights/boss-insights/versions/d08a107895ad/schema)