---
title: "Get Break Policy Suggestions"
method: POST
path: "/api/v1/time-tracking/break-policies/suggestions"
tags: ["Meal & Rest Breaks", "Public API"]
---

# Get Break Policy Suggestions

`POST /api/v1/time-tracking/break-policies/suggestions`

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/time-tracking/break-policies/suggestions`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `/authorize.php`
    - Token URL: `/token.php` scopes: `time_tracking:breaks`
- TypeScript: <https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/time-tracking/break-policies/suggestions/post.ts> (a function with typed inputs; its response is checked against the schema)

Uses an AI agent to analyze existing break policies and company context, then returns structured meal and rest break policy recommendations ready for form pre-fill.

OAuth Scopes: time_tracking:breaks

## Request body

- object
  - `prompt` string, required: The user's request or question for break policy suggestions (e.g. "What policies do we need for our California employees?")

## Response `200`

Suggestions returned successfully

- object
  - `suggestedPolicies` object[]
    - `id` string, required
    - `title` string, required
    - `description` string, nullable
    - `breaks` object[], required
      - `name` string, required
      - `duration` integer, required
      - `paid` boolean, required
      - `availabilityType` 'anytime' | 'hours_worked' | 'time_of_day', required
      - `availabilityMinHoursWorked` number, nullable

## Other responses

- `422`: Invalid request — prompt is missing or empty
- `500`: Internal server error — agent workflow failed

---

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