---
title: "Updates a Leave"
method: PUT
path: "/api/2026-07-01/resources/timeoff/leaves/{id}"
tags: ["Timeoff > Leave"]
---

# Updates a Leave

`PUT /api/2026-07-01/resources/timeoff/leaves/{id}`

Updates a Leave

## Path parameters

- `id` string, required

## Request body

- object
  - `id` string, required — The leave id
  - `employee_id` string — The employee id of the leave
  - `leave_type_id` string — The leave type id
  - `description` string — The description of the leave
  - `start_on` string — The valid start date of the leave following the format YYYY-MM-DD
  - `finish_on` string — The valid end date of the leave following the format YYYY-MM-DD
  - `half_day` string — If the leave is in: [beggining_of_day, end_of_day]
  - `start_time` string — The start time of a leave
  - `hours_amount_in_cents` integer — The hours amount in cents of a leave
  - `approved` boolean — Whether the leave is approved
  - `skip_notifications` boolean — Whether to skip notifications for this update
  - `skip_validations` boolean — Whether to skip validations for this update
  - `skip_medical_leave` boolean — Whether to skip medical leave processing for this update

## Response `200`

OK

- TimeoffLeave
  - `id` string, required — Identifier of the Leave
  - `company_id` string, required — Company identifier of the employee of the leave
  - `employee_id` string, required — Employee identifier of the leave
  - `start_on` string, required — The start date of the leave
  - `finish_on` string — The end date of the leave
  - `half_day` string — Indicates if the leave is taken as a half-day
  - `description` string — A description of the leave
  - `reason` string — The reason provided by the employee for taking the leave
  - `leave_type_id` string — The identifier for the type of leave
  - `leave_type_name` string — The name of the leave type
  - `approved` boolean — Indicates whether the leave has been approved
  - `employee_full_name` string — The full name of the employee taking the leave
  - `start_time` string — The start time of the leave
  - `hours_amount_in_cents` integer — The total number of hours taken for the leave, represented in cents
  - `updated_at` string, required — The updated at date of the leave
  - `created_at` string — The created at date of the leave
  - `deleted_at` string — The date when the leave was deleted
  - `duration_attributes` string — The duration attributes of the leave
  - `days_taken` number, required — Number of days taken for paid leave

---

[API](https://skmtc.net/factorialhr/apis/factorial-api.md) · [All operations](https://skmtc.net/factorialhr/apis/factorial-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/factorialhr/factorial-api/versions/1a6bffb20f7d/schema)