---
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`

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.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/revisions/19ebf391a399/schema)