v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
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}

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