v1
latestOpenAPI 3.1.02026-07-243113441.2 MBContractors
Cancel a pending contractor rehire
Purpose
Cancels a pending contractor rehire. For future-dated rehires, cancellation is available anytime before the date. For past-dated rehires, cancellation is only available within the 2-day grace period.
Prerequisites
Before calling this endpoint:
- The contractor must have a pending rehire (upcoming employment)
Related webhooks
- contractor.deactivated: Fires when the contractor returns to inactive state after cancellation
scope: contractors:write
delete/v1/contractors/{contractor_uuid}/rehire
Path parameters
contractor_uuidstring required
The UUID of the contractor
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
no content