v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Departments

Update a department

Update a department

scope: departments:write

put/v1/departments/{department_uuid}

Path parameters

department_uuidstring required

The UUID of the department

Headers

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

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Request body

versionstring required

The current version of the object. See the versioning guide for information on how to use this field.

titlestring required

Name of the department

Example request

{
  "version": "56d00c178bc7393b2a206ed6a86afcb4",
  "title": "Stage Hand"
}

Response

Success

versionstring

The current version of the object. See the versioning guide for information on how to use this field.

uuidstring

The UUID of the department

company_uuidstring

The UUID of the company

titlestring

Name of the department