---
title: "Save budget guidelines"
method: PUT
path: "/api/v1/compensation/planning_cycles/{id}/budgets/guidelines"
tags: ["Compensation Planning", "Public API"]
---

# Save budget guidelines

`PUT /api/v1/compensation/planning_cycles/{id}/budgets/guidelines`

Save budget guidelines for a compensation planning cycle.

OAuth Scopes: planning_cycles.write

## Path parameters

- `id` integer, required

## Request body

- object
  - `useGuidelines` boolean
  - `softMin` number
  - `softMax` number

## Response `200`

Guidelines saved successfully

- BudgetGuidelinesView — Budget guidelines for compensation planning budgets
  - `useGuidelines` boolean — Whether to use budget guidelines
  - `softMinimum` number, nullable — Soft minimum budget guideline
  - `softMaximum` number, nullable — Soft maximum budget guideline
  - `guidelinesWarningErrors` BudgetGuidelinesWarnings — Warning messages for saved budget guidelines
    - `softMinimumWarningMessage` string, nullable — Soft minimum warning message
    - `softMaximumWarningMessage` string, nullable — Soft maximum warning message
  - `requireComments` boolean — Whether a comment is required for recommendations outside of guidelines

## Other responses

- `400` — Invalid request data
- `403` — Insufficient permissions
- `404` — Resource not found
- `500` — Internal server error

---

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