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