---
title: "Sync Break Policy"
method: PUT
path: "/api/v1/time-tracking/break-policies/{id}/sync"
tags: ["Meal & Rest Breaks", "Public API"]
---

# Sync Break Policy

`PUT /api/v1/time-tracking/break-policies/{id}/sync`

Performs a full replacement of a break policy and its related data (breaks and employee assignments). Unlike the partial update endpoint, this replaces the entire policy state with the provided payload, removing any breaks or assignments not included in the request.

OAuth Scopes: time_tracking:breaks.write

## Path parameters

- `id` string, uuid, required

## Request body

- TimeTrackingSyncTimeTrackingBreakPolicyV1 — Data contract for syncing a break policy
  - `name` string — Name of the break policy
  - `description` string, nullable — Optional description of the break policy
  - `allEmployeesAssigned` boolean — Whether all employees are assigned to this break policy
  - `breaks` TimeTrackingCreateOrUpdateTimeTrackingBreakWithoutPolicyV1[] — Collection of time tracking breaks to create or update without a policy
    - `id` string, uuid, nullable — The unique identifier of the break. If not included, a new break will be created.
    - `name` string — The name of the break
    - `paid` boolean — Whether the break is paid
    - `duration` integer — Duration of the break in minutes
    - `availabilityType` 'anytime' | 'hours_worked' | 'time_of_day' — When the break is available to be taken
    - `availabilityMinHoursWorked` number, float, nullable — Minimum hours that must be worked before the break can be taken
    - `availabilityMaxHoursWorked` number, float, nullable — Maximum hours that can be worked before the break must be taken
    - `availabilityStartTime` string, time, nullable — Earliest time the break can be taken (HH:MM format)
    - `availabilityEndTime` string, time, nullable — Latest time the break can be taken (HH:MM format)
  - `employeeIds` integer[] — The employees that should be assigned to this policy

## Response `200`

Break policy synced successfully

- TimeTrackingTimeTrackingBreakPolicyWithRelationsV1 — A break policy for time tracking
  - `id` string, uuid — Unique identifier for the break policy
  - `name` string — Name of the break policy
  - `description` string, nullable — Optional description of the break policy
  - `allEmployeesAssigned` boolean — Whether all employees are assigned to this break policy
  - `createdAt` string, date-time — ISO 8601 timestamp when the break policy was created
  - `updatedAt` string, date-time, nullable — ISO 8601 timestamp when the break policy was last updated
  - `deletedAt` string, date-time, nullable — ISO 8601 timestamp when the break policy was deleted
  - `breaks` TimeTrackingTimeTrackingBreakV1[] — The breaks that are assigned to this policy
    - `id` string, uuid — The unique identifier for the time tracking break
    - `name` string — The name of the break
    - `policyId` string, uuid — The unique identifier of the break policy this break belongs to
    - `paid` boolean — Whether the break is paid
    - `duration` integer — Duration of the break in minutes
    - `availabilityType` 'anytime' | 'hours_worked' | 'time_of_day' — When the break is available to be taken
    - `availabilityMinHoursWorked` number, float, nullable — Minimum hours that must be worked before the break can be taken
    - `availabilityMaxHoursWorked` number, float, nullable — Maximum hours that can be worked before the break must be taken
    - `availabilityStartTime` string, time, nullable — Earliest time the break can be taken (HH:MM format)
    - `availabilityEndTime` string, time, nullable — Latest time the break can be taken (HH:MM format)
    - `createdAt` string, date-time — ISO 8601 timestamp when the break was created
    - `updatedAt` string, date-time, nullable — ISO 8601 timestamp when the break was last updated
    - `deletedAt` string, date-time, nullable — ISO 8601 timestamp when the break was deleted
  - `employeeIds` integer[] — The employees that are assigned to this policy

## Other responses

- `403` — Forbidden
- `404` — Break policy not found
- `422` — Invalid data provided

---

[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)