Logged Time Guidelines

Tracking time to an assignment reduces the estimate and keeps the schedule up to date.

Enter time in minutes, with a date, optional time tracking note, and cost code (if it’s required in your workspace).

Logged Time Entry Fields

Field NameField TypeDescriptionNote
idnumbertime entry ID
datedate pattern: yyyy-mm-dddate of workToday or another date.
notetextoptional timesheet noteNote is appended as subsequent updates are made.
loggedEntriesInMinutesnumbertime worked in minutes
costCodeIdnumberhow time was spentRequired in some workspaces. See guidelines below.
itemId numberAssignment ID
userIdnumbermember or resource tracking timeAn error is generated when the userID doesn’t match the assigned user.

Will use the current user if already assigned and not sent.
assignmentCompletedbooleanmark the assignment done (optional)Value isn't returned in the response.

Using Cost Codes

Cost Codes capture categories of work so you can understand where time goes. Organization Administrators and Workspace Managers create Cost Codes and enforce their usage through two optional workspace settings:

  1. Default Cost Code automatically adds the designated Cost Code when new assignments are created.
  2. Cost Code Required ensures time tracking is disabled when a Cost Code isn't present.

These are found in Workspace Settings under Administration in the left-side navigation.

Tracking for the first time: if the workspace has a default cost code, it will be applied on your behalf. Enter a cost code to override the default. If the workspace isn’t using cost codes or doesn’t require them, this field can be left blank.

Tracking to an assignment where time has already been logged: the field will default to the cost code already added (if one is present). It will remain blank if no cost code is present or, if workspace settings don’t require it.

The API will not accept an archived cost code. See your Organization Administrator if you receive an error because a cost code is no longer valid.