The Time Records resource represents system user entered time sheets. Time records MAY be linked to the Actions resources via the Tasks resources. Time Records have both an actual time value and a billable time value. No end timestamp for a time record exists, but is calculated using the "start" field and the "actualHours" field. Time Records are also specific to a division, which can be access via the Divisions resource.
Resource Properties
| Location | /timerecords |
|---|---|
| Methods | GET POST PUT DELETE OPTIONS |
| Default Page Size | 50 |
| Max Page Size | 100 |
| Default Includes | None |
Resource Attributes
| Field | Description | Format | Required | Field Type | Notes |
|---|---|---|---|---|---|
| startTimestamp | Timestamp representing the start date/time of the record | timestamp | true | default | |
| actualHours | The total duration of the time record | decimal | true | default | Cannot be less than zero. |
| billableHours | The total number of hours that are to be billed | decimal | false | default | Cannot be less than zero. |
| notes | A description of the time being recorded | string | false | default | |
| createdTimestamp | Timestamp of when the database record was created | timestamp | false | additional | |
| isTimesheetEntry | A flag for if the record was created through the timesheet interface or the time entry interface | boolean | false | additional | |
| owner | The system user to whom the time record belongs | string | true | link | |
| activity | The pre-defined activity associated with the time record | string | true | link | |
| division | The division to which the time record belongs | string | true | link | |
| task | The task against which the actual and billable time is logged | string | true | link | |
| createdBy | The system user who created the time record | string | true | link |
Link Templates
| Identifier | Resource | Location Template |
|---|---|---|
| timerecords.activity | timerecordactivities | /timerecordactivities/{timerecords.activity} |
| timerecords.division | divisions | /divisions/{timerecords.division} |
| timerecords.task | tasks | /tasks/{timerecords.task} |
| timerecords.owner | participants | /participants/{timerecords.owner} |
| timerecords.createdBy | participants | /participants/{timerecords.createdBy} |
Example Requests / Responses
- GET timerecords
- POST timerecords
- PUT timerecords
- DELETE timerecords