GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference

Cancel a pending contractor rehire

delete
https://api.gusto-demo.com/v1/contractors//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

Path Params
string
required

The UUID of the contractor

Headers
string
enum
Defaults to 2026-02-01

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

Allowed:
Responses
204

no content

Updated 2 days ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 days ago