GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference

Update a historical employee

put
https://api.gusto-demo.com/v1/companies//historical_employees/

Update a historical employee, an employee that was previously dismissed from the company in the current year.

scope: employees:manage

Path Params
string
required

The UUID of the company

string
required

The UUID of the historical employee

Body Params

Update a historical employee.

string
required

The current version of the object. See the versioning guide for information on how to use this field.

string
required
string
string
required
string
string
required
string
required
work_address
object
required
home_address
object
required
termination
object
required
string

Optional. If provided, the email address will be saved to the employee.

job
object
required
employee_state_taxes
object
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

404

Not Found

The requested resource does not exist. Make sure the provided UUID is valid.

Updated 5 months 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 5 months ago