Skip to main content
POST
Submit a leave request

Authorizations

X-Api-Key
string
header
required

Your API key, e.g. kua_live_… (or kua_test_… in test mode).

Body

application/json
employeeId
string<uuid>
required
leaveTypeId
string<uuid>
required
startDate
string<date>
required
endDate
string<date>
required
reason
string
required

Response

Created

A leave request and its decision state.

id
string<uuid>
required

The request's unique id.

employeeId
string<uuid>
required

The employee taking leave.

employeeName
null | string
required

The employee's name (present on list responses).

leaveTypeId
string<uuid>
required

The type of leave requested.

leaveTypeName
null | string
required

The leave type's name (present on list responses).

startDate
string<date>
required

First day of leave (inclusive).

endDate
string<date>
required

Last day of leave (inclusive).

workingDays
required

Working days (Mon–Fri) the request spans.

reason
string
required

The reason given.

status
string
required

One of Submitted, Approved, Rejected, Cancelled.

decisionComment
null | string
required

Approver/rejecter comment (required on rejection).

decidedAt
null | string<date-time>
required

When it was approved/rejected (null while pending).

createdAt
string<date-time>
required

When the request was submitted.