/timeclocks/:id Permission level: 5

put/timeclocks/{id}

Request

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

Path parameters

idinteger required

Request body application/x-www-form-urlencoded

start_datestring date
end_datestring date
scheduleinteger
employeeinteger
start_timestring date
end_timestring date
notesstring
approvedinteger

enum[0,1] -> 0: Unapproved; 1: Approved

tipsstring

Response

200

statusinteger
tokenstring
errorunknown

Example response

{
  "status": 1,
  "data": {
    "id": "46504362",
    "store": "251300",
    "status": "0",
    "schedule": {
      "id": "1324361",
      "name": "Customer service"
    },
    "notes": "I approved this timeclock",
    "created": "1470143432",
    "in_timestamp": "1470030480",
    "in_day": "2651",
    "out_timestamp": "1470057540",
    "out_day": "2651",
    "in_hour": "32",
    "out_hour": "62",
    "in_location": "Website",
    "out_location": "Website",
    "in_terminal": "0",
    "out_terminal": "-98",
    "approved_by": "2736727",
    "approved_time": "1470146295",
    "break_time": "0",
    "start_timestamp": "2016-08-01 07:48:00",
    "end_timestamp": "2016-08-01 15:19:00",
    "employee": {
      "id": "2744094",
      "name": "Josephine P. Watson"
    },
    "in_time": {
      "time": "7:48am",
      "day": "Aug 1, 2016",
      "timestamp": "2016-08-01 07:48:00"
    },
    "length": {
      "hours": 7,
      "mins": 31,
      "total_hours": "7.52"
    },
    "out_time": {
      "time": "3:19pm",
      "day": "Aug 1, 2016",
      "timestamp": "2016-08-01 15:19:00"
    },
    "current_length": {
      "hours": 32,
      "mins": 10,
      "total_hours": "32.17"
    },
    "events": [
      {
        "id": "63256275",
        "type": "6",
        "timestamp": "2016-08-01 07:48:00",
        "clock_time": "46504362",
        "data": {
          "position": "1324361"
        }
      }
    ]
  },
  "token": "xxxxxxx"
}

Changes