Follow

Updating Estimates and Tracking Time

You can update your estimate, track hours worked, and add a comment with a single POST using the track_time method on tasks.

The following request tracks four hours of work on the task, and sets the remaining estimate to a low of 1.5 days and a high of 3 days.

% curl https://app.liquidplanner.com/api/workspaces/:id/tasks/:id/track_time \
-d '{ work: 4, low: "1.5d", high: "3d", "activity_id":12345 }'

Parameters include:

member_id
id of the member to track work against and comment as; optional, defaults to you (the current user) NOTE: you cannot track time for virtual members via the API.
work
hours worked; optional
activity_id
id of the activity for the work; required if you are using timesheets and provide a value for work
low
low estimate for remaining work, hours (or a string such as “4h”, “0.5d”); usually optional, must be provided if you provide high, and omitted or set to ‘0’ when setting is_done
high
high estimate for remaining work, hours (or a string such as “4h”, “0.5d”); usually optional, must be provided if you provide low, and omitted or set to ‘0’ when setting is_done
is_done
if true, marks task as done; low and high must each be omitted or explicitly zero
done_on
datetime on which the task was done; valid only when is_done=true, defaults to now
work_performed_on
datetime on which the work was performed, default now
comment
comment to add to the task, optional
note
note to add to the timesheet entry, optional
reduce_estimate
if true, reduces high and low remaining effort estimates by the hours in the work parameter; optional
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request