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

Authorizationstringheaderrequired

Bearer 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>required
roleInOrgIDstring<uuid>required
statusstringrequired

Available options: APPROVED, REJECTED, CANCELLED

rejectionReasonstring

Allowed: at most 500 characters

expectedStatusstring

Available options: REQUESTED, APPROVED, REJECTED, CANCELLED

expectedFingerprintstring

Allowed: at most 128 characters

Response

200Successful response
idstring<uuid>required
hrisTimeOffIDstring<uuid>required
statusstringrequired

Available options: REQUESTED, APPROVED, REJECTED, CANCELLED

startDatestring<date>required
endDatestring<date>required
400Bad request
401Unauthorized
403Forbidden
404Not found
409Conflict
429Response 429
Was this page helpful? Suggest edits