Time

• Get time
• Create time
• Update time
• Delete time
• Start timer
• Pause timer
• Stop timer

Get time

GET v3/projects/23423233/timesheets/23570135/time returns all time entries for the specified timesheet.

[
  {
    "id": 80870831,
    "status": "billable",
    "description": "Brainstorm session with potential users",
    "date": "2016-10-05",
    "logged_hours": 2,
    "logged_mins": 30,
    "timer": false,
    "project": {
      "id": 23423233,
      "name": "PH Marketing"
    },
    "timesheet": {
      "id": 23570135,
      "title": "Prepare training material"
    }
  },
  {
    "id": 80870832,
    "status": "none",
    "date": "2016-10-05",
    "logged_hours": 1,
    "logged_mins": 20,
    "timer": true,
    "project": {
      "id": 23423233,
      "name": "PH Marketing"
    }
  }
]

Create time

POST v3/projects/23423233/timesheets/23570135/time creates a new time entry.

Request Body

{
  "project": 5211423221,
  "timesheet_id": 7537277243,
  "date": "2016-10-05",
  "logged_hours": "1",
  "logged_mins": "40",
  "status": "billable",
  "description": "Brainstorm session with potential users",
  "list_id": 261755063515,
  "task_id": 270733481758
}

project and timesheet_id are required. At least one of logged_hours or logged_mins must be provided.

To link a time entry to a task, both list_id and task_id must be supplied.

200 OK is returned along with the created time entry.

Update time

PUT v3/projects/23423233/timesheets/23570135/time/80870831 updates an existing time entry.

{
  "date": "2016-10-05",
  "logged_hours": "1",
  "logged_mins": "40",
  "status": "billable",
  "description": "Brainstorm session with potential users"
}

200 OK is returned along with the updated time entry.

Delete time

DELETE v3/projects/23423233/timesheets/23570135/time/80870831 deletes the specified time entry.

204 No Content is returned if the entry is deleted successfully. 403 Forbidden is returned if access is denied.

Start timer

PUT PUT v3/timer starts an automatic timer for the current user.

{
  "project_id": 23423233,
  "timesheet_id": 23570135,
  "timer_status": "start"
}

200 OK is returned along with the timer entry details.

Pause timer

PUT v3/timer/2357013 pauses a running timer.

{
  "pause_time": "05:02:21",
  "timer_status": "pause"
}

200 OK is returned along with the updated timer details.

Stop timer

DELETE v3/timer/2357013 stops and removes the active timer.

Stopping a timer permanently ends the running session. A new timer must be started to continue tracking time.

204 No Content is returned if the timer is stopped successfully. 403 Forbidden is returned if access is denied.