---
title: "Update pay bands"
method: PUT
path: "/api/v1/pay-grades-and-bands/pay-bands"
tags: ["Public API"]
---

# Update pay bands

`PUT /api/v1/pay-grades-and-bands/pay-bands`

Bulk update pay bands for compensation levels.

OAuth Scopes: pay_grades_and_bands.write

## Request body

- object
  - `payBandType` 'percentRange' | 'minMidMax', required
  - `payBands` LevelsAndBandsPayBand[], required
    - `levelId` integer, nullable — The level ID
    - `min` number, float — The minimum value for the level
    - `mid` number, float — The middle value for the level
    - `max` number, float — The maximum value for the level
    - `currencyCode` string, nullable — The currency code for the level
    - `percentageRange` number, float — The percentage range for the level
    - `compensationType` string — The compensation type for the level

## Response `200`

Successfully updated pay bands

- object
  - `status` string

## Other responses

- `400` — Invalid pay bands payload
- `403` — Insufficient permissions
- `500` — Internal server error

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/versions/19ebf391a399/schema)