---
title: "Update Job Code"
method: PUT
path: "/apiHub/payroll/v1/companies/{companyId}/jobs/{jobCode}"
tags: ["Job Codes"]
---

# Update Job Code

`PUT /apiHub/payroll/v1/companies/{companyId}/jobs/{jobCode}`

## Request

- Base URL: `dc1demogwext.paylocity.com` (relative, and the document’s source URL is not known)
- URL: `dc1demogwext.paylocity.com/apiHub/payroll/v1/companies/{companyId}/jobs/{jobCode}`
- Auth: none declared

**Summary Description**

The PUT Job Code method allows users to update the configuration of an existing Job Code within a specific company. The `PUT` method is designed to perform a full replacement of the resource. When a `PUT` request is made, the entire Job Code record is overwritten with the contents of the payload. This means that any fields omitted in the request will be set to `null` or their system defaults.

To use this endpoint, the payload must follow the schema defined by the Paylocity API for the Job Code object. Both the **Company ID** and **Job Code ID** are required path parameters.

This endpoint is typically used in scenarios where a complete update to a Job Code is necessary, such as modifying compensation groups, classifications, or job descriptions.

**Use Cases**

- Update existing Job Codes in Paylocity with new information. *Please note: All PUT requests will overwrite all data on the Job Code.*

## Path parameters

- `companyId` string, required
- `jobCode` string, required

## Headers

- `Authorization` string

## Request body

- UpdateJobCodeDto: Job Details
  - `description` string, nullable: The Job Code description may contain up to 40 alpha-numeric characters. Spaces or special characters are not allowed
  - `isActive` boolean, nullable: Active (Yes/No). The job code is currently active or inactive
  - `isCertified` boolean, nullable: Certified Job (Yes/No). This is a certified job code as per the CMS PBJ Report (Centers for Medicare and Medicaid Services Payroll Based Journal) job costing report by industry
  - `payEntry` PayEntryDto: Override Pay Entry Only
    - `shift` string, nullable: This field is used to enter an override company-defined shift code to be charged by the employee
    - `rateCode` string, nullable: The employee’s pay rate. If no rate is entered, the employees base rate will be used
    - `rate` number, double, nullable: The rate of pay for the job code
    - `addingRateConstant` number, double, nullable: Rate + or + Is employee pay rate + the SD Schedule Differential plus or times the bonus
    - `multiplyingRateConstant` number, double, nullable: Rate X or + Is employee pay rate X the SD Schedule Differential plus or times the bonus
    - `workerComputedCode` string, nullable: The company defined workers comp code for work performed by the employee
    - `tax` TaxDto: State Tax
      - `state` string, nullable: State
      - `local1` string, nullable: This is the local tax code used for the job code
      - `local2` string, nullable: This is the second local tax code used for the job code
      - `local3` string, nullable: This is the third local tax code used for the job code
  - `address` CompanyAddressDto: Address
    - `line1` string, nullable: The address where the job code will be used
    - `line2` string, nullable: The address where the job code will be used
    - `city` string, nullable: The city where the job code will be used
    - `state` string, nullable: The state where the job code will be used
    - `zip` string, nullable: The zip code where the job code will be used
    - `county` string, nullable: The county where the job code will be used
    - `country` string, nullable: The country where the job code will be used
  - `payrollBasedJournal` PayrollBasedJournalDto: CMS/PBJ Data Only
    - `jobTitleCode` string, nullable: This is a Job Title Code for which the certified job code CMS PBJ Report (Centers for Medicare and Medicaid Services Payroll Based Journal) will be utilized to calculate labor costs
    - `facilityId` string, nullable: This is a Facility id for which the certified job code CMS PBJ Report (Centers for Medicare and Medicaid Services Payroll Based Journal) will be utilized to calculate labor costs
    - `stateId` string, nullable: This is a State ID for which the certified job code CMS PBJ Report (Centers for Medicare and Medicaid Services Payroll Based Journal) will be utilized to calculate labor costs

## Response `200`

OK

---

[API](https://skmtc.dev/paylocity/apis/company-level-information.md) - [All operations](https://skmtc.dev/paylocity/apis/company-level-information/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/company-level-information/revisions/b0d2a79e4eac?raw)