GuidesAPI ReferenceChangelog
API Reference

Requests a change to an approved leave

post
https://api.factorialhr.com/api/2027-01-01/resources/timeoff/leave_change_requests

The owner of an approved leave proposes new values for it, or its cancellation, when they can't make that change directly. The request goes to the employee's approval flow and the leave doesn't change until it is approved. A leave can have only one pending request, and a leave that has started can't be changed.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Id of the approved leave to change.

string
enum
required

update_leave to propose new values, cancel_leave to cancel the leave.

Allowed:
string

Proposed first day. Omit it to keep the current one.

string

Proposed last day. Omit it to keep the current one.

string

Proposed half day (beggining_of_day or end_of_day), or an empty string to make a half-day leave a full day. Omit it to keep the current one.

string

Proposed start time for an hourly leave. Omit it to keep the current one.

integer

Proposed hours for an hourly leave, in cents of an hour. Omit it to keep the current one.

string

Proposed leave type. Omit it to keep the current one.

string

Proposed description of the leave. Omit it to keep the current one.

string

Why the employee asks for the change.

Responses

Updated about 18 hours ago

Did this page help you?
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 18 hours ago

Did this page help you?