POST /rest/v1.0/workforce-planning/v2/companies/{company_id}/job-titles/{job_title_id}

Updates a Job Title given a company ID and job title ID.

Servers

Path parameters

Name Type Required Description
company_id Yes

Unique identifier for the company. This parameter accepts both formats:

  • Recommended: Procore company ID (integer) - Use this for new integrations
  • Legacy: LaborChart UUID format (uuid string) - Supported for backward compatibility

A proxy layer automatically handles both formats, but using the Procore company ID is preferred for consistency with other Procore APIs.

job_title_id String Yes

Unique identifier for the Job Title.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Procore-Company-Id Integer Yes

Unique company identifier associated with the Procore User Account.

Request body fields

Name Type Required Description
name String Yes

Name of the Job Title.

globally_accessible Boolean No

Controls whether the Job Title is globally available to all current and future Groups.

type String Yes

Specifies the Job Title type. - hourly - Hourly wage-based job title. - salaried - Fixed salary job title.

Possible values:

  • "salaried"
  • "hourly"
hourly_rate Number No

Hourly wage rate for the Job Title. Required if type is hourly.

color String No

Hexadecimal color code for the Job Title. Helps with categorization and visual distinction.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.