Pay Grades & Bands
Public API

Replace Job Title Level Assignments

Changed on

Replaces the complete set of draft job title-to-compensation-level assignments with the associations in the request. This is a full replacement: all existing draft job title assignments are deleted and replaced with those supplied, so any assignment omitted from the request is removed from the draft. Each entry pairs a job title with the compensation level it should map to. This endpoint writes only job-title assignments; define group and level structure with Update Compensation Level Groups and Levels (update-compensation-level-groups-and-levels) and set pay band values with Update Pay Bands (update-pay-bands). If no draft exists yet, one is created from the published structure and the supplied published level IDs are remapped onto the newly created draft levels, so later reads return draft-specific level IDs. Every target level must belong to a draft group, otherwise the request fails with 400. Discover job title and level IDs with Get Job Titles and Level Assignments (get-job-title-level-assignments). Assignments are written to the draft only; publish them with Publish Draft Compensation Level Groups (publish-draft-compensation-level-groups). Returns an object with a single status field set to success.

OAuth Scopes: pay_grades_and_bands.write

put/api/v1/pay-grades-and-bands/job-titles

Request

Request body

Response

Draft job title assignments replaced. Returns an object with a status field set to success.

statusstring

Example response

{
  "status": "success"
}

Changes

    • breaking

      the request property // became required

    • breaking

      the request property // became required

    • info

      api operation id 2a0b847ceec3a4f9bfe20cf27e10e81a removed and replaced with replace-job-title-level-assignments

    • info

      api tag Pay Grades & Bands added