---
title: "Remove people from a department"
method: PUT
path: "/v1/departments/{department_uuid}/remove"
tags: ["Departments"]
---

# Remove people from a department

`PUT /v1/departments/{department_uuid}/remove`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/departments/{department_uuid}/remove`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/departments/:department_uuid/remove/put.ts> (a function with typed inputs; its response is checked against the schema)

Remove employees and contractors from a department

scope: `departments:write`

## Path parameters

- `department_uuid` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Request body

- DepartmentPeopleRequestBody
  - `version` string, required: The current version of the object. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information on how to use this field.
  - `employees` object[]: Array of employees to add or remove from the department
    - `uuid` string
  - `contractors` object[]: Array of contractors to add or remove from the department
    - `uuid` string

## Response `200`

Success

- Department
  - `version` string: The current version of the object. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information on how to use this field.
  - `uuid` string: The UUID of the department
  - `company_uuid` string: The UUID of the company
  - `title` string: Name of the department
  - `employees` object[]: Array of employees assigned to the department.
    - `uuid` string
  - `contractors` object[]: Array of contractors assigned to the department.
    - `uuid` string

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `422`: Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

[API](https://skmtc.dev/gusto/apis/gusto-api.md) - [All operations](https://skmtc.dev/gusto/apis/gusto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gusto/apis/gusto-api/revisions/f98575fa2a5e?raw)