Time off & holidays
Update Hris Time Off Status
Approves, rejects or cancels a time-off request under transition rules, logging and notifying.
POSThttps://api.toku.com/hris/update-hris-time-off-status
Not available to API keys yet. It will need time:write.
curl --request POST \
--url 'https://api.toku.com/hris/update-hris-time-off-status' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"hrisTimeOffID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"roleInOrgID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "APPROVED",
"rejectionReason": "string",
"expectedStatus": "REQUESTED",
"expectedFingerprint": "string"
}'200 response
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"hrisTimeOffID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "REQUESTED",
"startDate": "2026-01-01",
"endDate": "2026-01-01"
}Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is an access token from a Toku sign-in. See Authentication in the API reference.
Body
application/json
hrisTimeOffIDstring<uuid>requiredroleInOrgIDstring<uuid>requiredstatusstringrequiredAvailable options: APPROVED, REJECTED, CANCELLED
rejectionReasonstringAllowed: at most 500 characters
expectedStatusstringAvailable options: REQUESTED, APPROVED, REJECTED, CANCELLED
expectedFingerprintstringAllowed: at most 128 characters
Response
200Successful response
idstring<uuid>requiredhrisTimeOffIDstring<uuid>requiredstatusstringrequiredAvailable options: REQUESTED, APPROVED, REJECTED, CANCELLED
startDatestring<date>requiredendDatestring<date>required400Bad request
401Unauthorized
403Forbidden
404Not found
409Conflict
429Response 429
Was this page helpful? Suggest edits