---
title: "Delete groups by status or delete one level"
method: DELETE
path: "/api/v1/pay-grades-and-bands/levels/{segment}"
tags: ["Public API"]
---

# Delete groups by status or delete one level

`DELETE /api/v1/pay-grades-and-bands/levels/{segment}`

Delete compensation level groups when `segment` is `draft`, `published`, or `historic`, or delete a single compensation level when `segment` is a numeric level identifier.

OAuth Scopes: pay_grades_and_bands.write

## Path parameters

- `segment` string, required

## Response `200`

Successfully deleted groups (`{"status":"success"}`) or returned updated hierarchy after deleting a level.

- object

## Other responses

- `400` — Invalid segment
- `403` — Insufficient permissions
- `404` — Level not found
- `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)