ACH Transactions1

Bank Accounts5

Companies18

Company Attachment4

Company Benefits13

Company Forms4

Contractor Documents4

Contractor Forms4

Contractor Payment Groups8

Contractor Payment Method4

Contractor Payments9

Contractors14

Departments7

Earning Types4

Employee Addresses10

Employee Benefits11

Employee Employments10

Employee Forms5

Employee Payment Method6

Employee Tax Setup4

Employees13

Events1

External Payrolls9

Federal Tax Details2

Flows1

Garnishments5

Generated Documents1

Holiday Pay Policies7

I-9 Verification7

Industry Selection2

Information Requests1

Introspection2

Invoices1

Jobs and Compensations10

Locations5

Member Portal Invitations6

Notifications2

Pay Schedules9

Payment Configs2

Payroll Cancellations2

Payroll Digests2

Payrolls20

People Batches2

Recovery Cases2

Reimbursements5

Reports7

Reverse Wire Transactions1

Salary Estimates5

Signatories5

Tax Payments2

Tax Requirements3

Time Off Policies9

Time Off Requests9

Webhooks8

Wire In Requests3

Jobs and Compensations

Update a job

Changed on Nov 3, 2026

Update a job.

scope: jobs:write

put/v1/jobs/{job_id}

Request

Base URL
https://api.gusto-demo.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/gusto/apis/gusto-api/docs/v1/jobs/:job_id/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

job_idstring required

The UUID of the job

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.

Request body

versionstring required

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

titlestring nullable

The job title.

hire_datestring

The date when the employee was hired or rehired for the job.

two_percent_shareholderboolean

Whether the employee owns at least 2% of the company.

state_wc_coveredboolean nullable

Whether this job is eligible for workers' compensation coverage in the state of Washington (WA).

state_wc_class_codestring nullable

The risk class code for workers' compensation in Washington state. Please visit Washington state's Risk Class page to learn more.

Example request

{
  "version": "56d00c178bc7393b2a206ed6a86afcb4",
  "title": "Regional Manager",
  "hire_date": "2020-12-21"
}

Response

successful blank title on a non-primary active job

uuidstring required

The UUID of the job.

versionstring

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

employee_uuidstring

The UUID of the employee to which the job belongs.

hire_datestring

The date when the employee was hired or rehired for the job.

titlestring nullable

The title for the job.

primaryboolean

Whether this is the employee's primary job. The value will be set to true unless an existing job exists for the employee.

ratestring

The employee's pay rate for this job (e.g., hourly wage or annual salary). This is sensitive compensation data and requires the compensations:read scope.

payment_unitstring nullable

How the employee is paid for this job (e.g., Hour, Week, Month, Year, Paycheck). This is sensitive compensation data and requires the compensations:read scope.

current_compensation_uuidstring nullable

The UUID of the current active compensation record for this job. Null when the job has no current compensation. Requires the compensations:read scope.