---
title: "Deactivate a time off policy"
method: PUT
path: "/v1/time_off_policies/{time_off_policy_uuid}/deactivate"
tags: ["Time Off Policies"]
---

# Deactivate a time off policy

`PUT /v1/time_off_policies/{time_off_policy_uuid}/deactivate`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/time_off_policies/{time_off_policy_uuid}/deactivate`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/time_off_policies/:time_off_policy_uuid/deactivate/put.ts> (a function with typed inputs; its response is checked against the schema)

Deactivate a time off policy

scope: `time_off_policies:write`

## Path parameters

- `time_off_policy_uuid` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Response `200`

successful

- TimeOffPolicy: Representation of a Time Off Policy
  - `uuid` string, required: Unique identifier of a time off policy
  - `company_uuid` string, required: Unique identifier for the company owning the time off policy
  - `name` string, required: Name of the time off policy
  - `policy_type` 'vacation' | 'sick' | 'bereavement' | 'custom' | 'floating_holiday' | 'jury_duty' | 'learning_and_development' | 'parental_leave' | 'personal_day' | 'volunteer' | 'weather', required: Type of the time off policy. Only "vacation" and "sick" can be created through the API, but other types may be present if the company was previously a Gusto.com customer.
  - `accrual_method` string, required: Policy time off accrual method
  - `accrual_rate` string, float, nullable: The rate at which the time off hours will accrue for an employee on the policy. Represented as a float, e.g. "40.0".
  - `accrual_rate_unit` string, float, nullable: The number of hours an employee has to work or be paid for to accrue the number of hours set in the accrual rate. Only used for hourly policies (per_hour_paid, per_hour_paid_no_overtime, per_hour_work, per_hour_worked_no_overtime). Represented as a float, e.g. "40.0".
  - `paid_out_on_termination` boolean: Boolean representing if an employee's accrued time off hours will be paid out on termination
  - `accrual_waiting_period_days` integer, nullable: Number of days before an employee on the policy will begin accruing time off hours
  - `carryover_limit_hours` string, float, nullable: The max number of hours an employee can carryover from one year to the next
  - `max_accrual_hours_per_year` string, float, nullable: The max number of hours an employee can accrue in a year
  - `max_hours` string, float, nullable: The max number of hours an employee can accrue
  - `policy_reset_date` string, nullable: The date the policy resets. Format MM-DD
  - `complete` boolean: boolean representing if a policy has completed configuration
  - `version` string, nullable: The current version of the object. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/versioning#object-layer) for information on how to use this field. The version will be null if the policy is no longer active.
  - `is_active` boolean, required: boolean representing if a policy is active or not
  - `employees` object[], required: List of employee UUIDs under a time off policy
    - `uuid` string
    - `balance` string: The time off balance for the employee

## Other responses

- `404`: Not Found
- `422`: Policy has pending time off requests

---

[API](https://skmtc.dev/gusto/apis/gusto-api.md) - [All operations](https://skmtc.dev/gusto/apis/gusto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gusto/apis/gusto-api/revisions/f98575fa2a5e?raw)