Leaves

Update a leave request.

Update a leave request.

put/leaves/{id}

Request

  • Base URL: https://api.floorworks.co.uk/api/v1
  • URL: https://api.floorworks.co.uk/api/v1/leaves/{id}
  • Auth: OAuth 2 (password, token URL https://api.floorworks.co.uk/api/v1/auth)

Path parameters

idinteger required

Leave request ID.

Request body

type'SICK_LEAVE' | 'HOLIDAY_LEAVE' | 'UNPAID_ABSENCE' | 'AUTHORISED_ABSENCE' | 'MATERNITY_PATERNITY' | 'MEDICAL_APPOINTMENT' | 'UNAUTHORISED_ABSENCE' | 'OTHER'

Leave type.

status'REQUESTED' | 'APPROVED' | 'REJECTED'

Leave request status.

time_startinteger

Start date/time (Unix timestamp).

time_endinteger

End date/time (Unix timestamp).

contact_idstring uuid

ID of the contact that is associated with this document.

manager_contact_idstring uuid

Manager Id.

descriptionstring nullable

Long-form description.

external_id_payrollstring nullable

Reference ID from external payroll system.

contract_standard_hoursnumber float nullable

Contracted standard paid hours for this leave period.

contract_standard_hours_unpaidnumber float nullable

Contracted standard unpaid hours for this leave period.

Example request

{
  "time_start": 1755388800,
  "time_end": 1755475200
}

Response

OK

type'SICK_LEAVE' | 'HOLIDAY_LEAVE' | 'UNPAID_ABSENCE' | 'AUTHORISED_ABSENCE' | 'MATERNITY_PATERNITY' | 'MEDICAL_APPOINTMENT' | 'UNAUTHORISED_ABSENCE' | 'OTHER'

Leave type.

status'REQUESTED' | 'APPROVED' | 'REJECTED'

Leave request status.

time_startinteger

Start date/time (Unix timestamp).

time_endinteger

End date/time (Unix timestamp).

contact_idstring uuid

ID of the contact that is associated with this document.

manager_contact_idstring uuid

Manager Id.

descriptionstring nullable

Long-form description.

external_id_payrollstring nullable

Reference ID from external payroll system.

contract_standard_hoursnumber float nullable

Contracted standard paid hours for this leave period.

contract_standard_hours_unpaidnumber float nullable

Contracted standard unpaid hours for this leave period.

idnumber

ID.

time_createdstring YYYY-MM-DD

Creation date

time_modifiedstring YYYY-MM-DD

Last modification date

Example response

{
  "time_start": 1755388800,
  "time_end": 1755475200,
  "id": 12345,
  "time_created": "2025-08-17",
  "time_modified": "2025-08-18"
}

Changes

No recorded changes to this operation across all 1 revision of this API.