Contractors
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.reactivation_cancelled: Fires when the pending rehire is cancelled
scope: contractors:write
delete/v1/contractors/{contractor_uuid}/rehire
Request
- Base URLhttps://api.gusto-demo.com
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
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
Changes
No recorded changes to this operation across all 2 revisions of this API.