---
title: "Adjust Time Off Balance"
method: PUT
path: "/api/v1/employees/{employeeId}/time_off/balance_adjustment"
tags: ["Time Off", "Public API"]
---

# Adjust Time Off Balance

`PUT /api/v1/employees/{employeeId}/time_off/balance_adjustment`

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/employees/{employeeId}/time_off/balance_adjustment`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `/authorize.php`
    - Token URL: `/token.php` scopes: `time_off.write`
- TypeScript: <https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/employees/:employeeId/time_off/balance_adjustment/put.ts> (a function with typed inputs; its response is checked against the schema)

Creates a balance adjustment for an employee's time off type. The adjustment is recorded as an override history item. Cannot adjust balances for discretionary (unlimited) time off types.

OAuth Scopes: time_off.write

## Path parameters

- `employeeId` integer, required

## Request body

- AdjustTimeOffBalance
  - `date` string, date, required: The date the adjustment should be added in history. Should be in ISO8601 date format (YYYY-MM-DD).
  - `timeOffTypeId` integer, required: The ID of the time off type to add a balance adjustment for.
  - `amount` number, required: The number of hours/days to adjust the balance by.
  - `note` string: This is an optional note to show in history.

## Response `201`

The balance adjustment has been created.

## Other responses

- `400`: Empty or malformed JSON/XML, an invalid date format, an invalid time off type, an invalid override amount, or an attempt to adjust a discretionary time off type.
- `401`: Unauthorized. Invalid API credentials.
- `403`: Insufficient permissions to perform this action.
- `404`: Employee not found.
- `503`: Service unavailable due to a database 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.dev/bamboohr/apis/bamboohr-api/revisions/922fc15f43a7?raw)