---
title: "Delete Time Off Policy"
method: DELETE
path: "/api/v1/time-off/policies/{id}"
tags: ["Time Off", "Public API"]
---

# Delete Time Off Policy

`DELETE /api/v1/time-off/policies/{id}`

## Request

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

Soft-deletes a time off policy. Every employee currently assigned to the policy is unassigned first and their assignment rows are archived, so a single call replaces what an admin does by hand; there is no conflict response for a policy that still has assignments. Historical balances and time off requests tied to the policy are retained; the policy simply stops appearing in policy lists and can no longer be assigned. The operation is idempotent: an id that has already been deleted, and an id no policy has ever carried, both return 204 rather than 404.

OAuth Scopes: time_off:policies.write

## Path parameters

- `id` integer, required

## Response `204`

The policy is deleted. Returned whether this call deleted it, an earlier call already did, or no policy with that id has ever existed. No response body.

## Other responses

- `401`: Unauthorized. Missing or invalid authentication.
- `403`: Forbidden. The caller does not have permission to manage time off policies, or the company does not have the Time Off product.

## Changes

- **2026-11-03** `922fc15f43a7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bamboohr/apis/bamboohr-api/changes/api/v1/time-off/policies/:id/delete.md)

---

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