Skip to main content
POST
Record a promotion

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
fromTitle
null | string
required
toTitle
string
required
fromDepartmentId
null | string<uuid>
required
toDepartmentId
null | string<uuid>
required
fromSalaryMinor
required
toSalaryMinor
required
effectiveDate
string<date>
required
reason
null | string
required

Response

Created

A promotion (or role/salary change) record.

id
string<uuid>
required
employeeId
string<uuid>
required
fromTitle
null | string
required
toTitle
string
required
fromDepartmentId
null | string<uuid>
required
toDepartmentId
null | string<uuid>
required
fromSalaryMinor
required

Previous salary in minor units (nullable).

toSalaryMinor
required

New salary in minor units (nullable).

effectiveDate
string<date>
required
reason
null | string
required
createdAt
string<date-time>
required