Update Pay Bands

Updates the pay band values (min, mid, max, percentageRange) for compensation levels in the company's draft pay grades and bands. This is the only endpoint that persists pay band values; Update Compensation Level Groups and Levels (update-compensation-level-groups-and-levels) defines the group and level structure but does not save band values. Job-title assignments are set separately with Replace Job Title Level Assignments (replace-job-title-level-assignments). Supply the level IDs returned by Get Pay Bands (get-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. When payBandType is percentRange, min and max are derived from mid and percentageRange and any supplied min/max are ignored; when minMidMax, the supplied min/mid/max are stored and percentageRange is cleared. Every target level must belong to a draft group, otherwise the request fails with 400. Values 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