Skip to main content
POST
Change a request

Authorizations

X-API-KEY
string
header
required

Path Parameters

id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Body

application/json
reason
string | null
start
string

Start/end of the request in ISO 8601. For day-based leave types (leave_unit: days) send the date at midnight UTC (e.g. 2026-06-01T00:00:00Z) and use start_at / end_at to set half-days. For hour-based leave types include the exact time of day (e.g. 2026-06-01T09:00:00Z); start_at / end_at are then ignored.

end
string

Start/end of the request in ISO 8601. For day-based leave types (leave_unit: days) send the date at midnight UTC (e.g. 2026-06-01T00:00:00Z) and use start_at / end_at to set half-days. For hour-based leave types include the exact time of day (e.g. 2026-06-01T09:00:00Z); start_at / end_at are then ignored.

start_at
enum<string>

For day-based leave types: whether the absence starts in the morning (the whole first day counts) or afternoon (only the second half of the first day). Ignored for hour-based leave types.

Available options:
morning,
afternoon
end_at
enum<string>

For day-based leave types: whether the absence ends at lunchtime (only the first half of the last day) or end_of_day (the whole last day counts). Ignored for hour-based leave types.

Available options:
lunchtime,
end_of_day
admin_approval_option
enum<string>
Available options:
approve_request_immediately,
go_through_the_normal_approval_process

Response

Successful response

id
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
revision
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
kind
enum<string>
required
Available options:
reason,
shortened,
extended,
moved,
leave_type
status
enum<string>
required
Available options:
pending,
approved,
declined,
withdrawn,
applied
previous
object
required

The request as it was before this change.

proposed
object
required

The request as this change wants it. For applied and approved changes this is what is in force.

changed_by
object | null
required
decided_by
object | null
required
created_at
string
required
decided_at
string | null
required
decision_reason
string | null
required