Employees

Delete an onboarding employee

Use this endpoint to delete an employee who is in onboarding. Deleting an onboarded employee is not allowed and will return a 422 response. Please check out the Terminations api if you need to terminate an onboarded employee.

scope: employees:manage

delete/v1/employees/{employee_id}

Request

Path parameters

employee_idstring required

The UUID of the employee

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.

Response

successful

Changes

No recorded changes to this operation across all 2 revisions of this API.