---
title: "Update a balance"
method: PATCH
path: "/v1/workspaces/{workspaceId}/time-off/balance/policy/{policyId}"
tags: ["Balance"]
---

# Update a balance

`PATCH /v1/workspaces/{workspaceId}/time-off/balance/policy/{policyId}`

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.
- `policyId` string, required — Represents a policy identifier across the system.

## Request body

- UpdateBalanceRequestV1
  - `dateRange` DateRangeV1Request — Represents the date range when the new balance will be usable. If null, this will default to the current day until the same day next year.
    - `end` string — Provide end date in YYYY-MM-DD format.
    - `start` string — Provide start date in YYYY-MM-DD format.
  - `note` string — Represents a new balance note value.
  - `sync` boolean — Indicates whether the call should be executed synchronously. By default, call is done asynchronously
  - `userIds` string[], required — Represents the list of users' identifiers whose balance is to be updated.
  - `value` number, double, required — Represents the change in balance value.

## Response `204`

No Content

## Changes

- **2026-08-20** `a5b636acbcd8` — 4 info
  - the `` request property default value `` was added
  - the `end` request property default value `` was added
  - the `note` request property default value `` was added
  - the `start` request property default value `` was added

[Change history](https://skmtc.dev/clockify/apis/clockify-api/changes/v1/workspaces/:workspaceId/time-off/balance/policy/:policyId/patch.md)

---

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