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:
- Default Cost Code automatically adds the designated Cost Code when new assignments are created.
- 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.
Updated 9 months ago