/leaves/:id Permission Level: 5

put/leaves/{id}?access_token=xxxx

Request

  • Base URL
    https://www.humanity.com/api/v2
  • Auth
    API key in query parameter access_token

Path parameters

idinteger required

Leave ID

Request body application/x-www-form-urlencoded

unique_idinteger

Custom unique identifier of a leave request.

start_datestring

Start date of a requested leave

end_datestring

End date of a requested leave

start_timestring

Start time of a requested leave

end_timestring

End time of a requested leave

commentsstring

Comments which an employee can send at the time of requesting

notesstring

Additional string field for holding notes.

statusinteger

enum[0, 1, -1, -2]. 0 - Pending for approval, 1 - Approved, -1 - Rejected, -2 - Employee cancelled request

force_user_timezoneinteger

enum[0, 1]

reasonstring

Notes that approver can add during approving or rejecting a leave request.

deduct_daysinteger

Number of days to deduct from total requested days

Response

200

statusinteger
tokenstring
errorunknown

Example response

{
  "status": 1,
  "data": {
    "id": "5369187",
    "user": "1537529",
    "store": "132017",
    "date": "1535491268",
    "requested_on": {
      "id": 3408,
      "month": 8,
      "day": 28,
      "wday": 2,
      "year": 2018,
      "weekday": "Tue",
      "mname": "Aug",
      "week": 35,
      "dayid": 3,
      "timeid": 85,
      "timeid_exact": 85,
      "formatted": "Aug 28, 2018",
      "iso8601": "2018-08-28T21:00:00+0200",
      "time": "21:00",
      "timestamp": 1535482800,
      "hours": 21,
      "date": "2018-08-28 21:00:00",
      "day_of_year": "239",
      "week_adjusted": 35,
      "sp_wday": 3
    },
    "approved_on": "0",
    "status": "1",
    "admin": "0",
    "start_day": {
      "id": 3594,
      "month": 3,
      "day": 2,
      "wday": 6,
      "year": 2019,
      "weekday": "Sat",
      "mname": "Mar",
      "week": 9,
      "dayid": 7,
      "timeid": 1,
      "timeid_exact": 1,
      "formatted": "Mar 2, 2019",
      "iso8601": "2019-03-02T00:00:00+0100",
      "time": "00:00",
      "timestamp": 1551481200,
      "date": "2019-03-02 00:00:00",
      "day_of_year": "60",
      "week_adjusted": 9,
      "sp_wday": 7
    },
    "end_day": {
      "id": 3598,
      "month": 3,
      "day": 6,
      "wday": 3,
      "year": 2019,
      "weekday": "Wed",
      "mname": "Mar",
      "week": 10,
      "dayid": 4,
      "timeid": 1,
      "timeid_exact": 1,
      "formatted": "Mar 6, 2019",
      "iso8601": "2019-03-06T00:00:00+0100",
      "time": "00:00",
      "timestamp": 1551826800,
      "date": "2019-03-06 00:00:00",
      "day_of_year": "64",
      "week_adjusted": 10,
      "sp_wday": 4
    },
    "requested_on_timestamp": "2018-08-28 21:00:00",
    "start_timestamp": "2019-03-02 00:00:00",
    "end_timestamp": "2019-03-07 00:00:00",
    "leave_type": "10530",
    "approved_by": "2864792",
    "rejected_by": "0",
    "rejected_on": "0",
    "is_hourly": "0",
    "unique_id": "10002",
    "deduct_days": "0",
    "created_at": "2018-08-28 23:21:08",
    "updated_at": "2019-01-10 17:35:41",
    "leave_type_name": "Sick Leave",
    "dont_deduct_from_vac": "0",
    "max_num_of_staff_at_once": "0",
    "employee": "1537529",
    "employee_name": "Developer Test 2",
    "until": {
      "id": 3599,
      "month": 3,
      "day": 7,
      "wday": 4,
      "year": 2019,
      "weekday": "Thu",
      "mname": "Mar",
      "week": 10,
      "dayid": 5,
      "timeid": 1,
      "timeid_exact": 1,
      "formatted": "Mar 7, 2019",
      "iso8601": "2019-03-07T00:00:00+0100",
      "time": "00:00",
      "timestamp": 1551913200,
      "date": "2019-03-07 00:00:00",
      "day_of_year": "65",
      "week_adjusted": 10,
      "sp_wday": 5
    },
    "length": 5,
    "total_days": 5,
    "total_human_friendly": "N/A",
    "total_time_alotted": {
      "d": 4,
      "invert": 1,
      "days": 4
    }
  },
  "token": "2e1d74bbde427052ba803f5198ee13f404107ffb"
}

Changes