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 Name

Field Type

Description

Note

id

number

time entry ID

date

date pattern: yyyy-mm-dd

date of work

Today or another date.

note

text

optional timesheet note

Note is appended as subsequent updates are made.

loggedEntriesInMinutes

number

time worked in minutes

costCodeId

number

how time was spent

Required in some workspaces. See guidelines below.

itemId

number

Assignment ID

userId

number

member or resource tracking time

An error is generated when the userID doesn’t match the assigned user.

Will use the current user if already assigned and not sent.

assignmentCompleted

boolean

mark 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.