API v1 ReferenceTime Entries

Creates a new time entry.

Creates a new time entry. Depending on the time entry, the calling users has to have several permissions to create the time entry. No permissions are required if the calling user is owner of this time entry. If the calling user is not the creator of the time entry and the time entry is connected to a project, ‘write’ permissions on the ‘project-timetracking’ feature are necessary. If the time entry is connected to a task, the user needs to be assignee of this task or the user needs permissions on: ‘project-planning-data’ if it is a project task.

Required Permissions
Any authenticated user.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
timezonestringRequired>=1 character
The original timezone of the time tracking. The format of the timezone is the IANA standard.
typeOfWorkIdUUIDRequired
The id of the type of work.
userIdUUIDRequired
The id of the user.
isBillablebooleanOptional
Whether the time tracking is billable or not.
isBilledbooleanOptional
Whether the time tracking is billed or not.
taskIdUUID or nullOptional
The id of the task.
projectIdUUID or nullOptional
The id of the project.
notestring or nullOptional
The note of the time tracking.
startDateUtcdatetime or nullOptional

The date (in UTC) when the time tracking was started.

startTimeUtcstring or nullOptional

The time (in UTC) when the time tracking was started.

endDateUtcdatetime or nullOptional

The date (in UTC) when the time tracking was stopped.

endTimeUtcstring or nullOptional

The time (in UTC) when the time tracking was stopped. Required when the time tracking has already been completed and Duration has not been set.

startDateLocaldatetime or nullOptional

The date (in Local) when the time tracking was started.

startTimeLocalstring or nullOptional

The time (in Local) when the time tracking was started.

endDateLocaldatetime or nullOptional

The date (in Local) when the time tracking was stopped.

endTimeLocalstring or nullOptional

The time (in Local) when the time tracking was stopped. Required when the time tracking has already been completed and Duration has not been set.

durationinteger or nullOptional
The duration of the time tracking in seconds. Required when the time tracking has already been completed and EndTime has not been set.
breakDurationinteger or nullOptional
The duration of the break in seconds. Cannot be set via API.

Response

OK
timezonestring>=1 character
The original timezone of the time tracking. The format of the timezone is the IANA standard.
typeOfWorkIdUUID
The id of the type of work.
isBillablebooleanOptional
Whether the time tracking is billable or not.
isBilledbooleanOptional
Whether the time tracking is billed or not.
taskIdUUID or nullOptional
The id of the task.
projectIdUUID or nullOptional
The id of the project.
notestring or nullOptional
The note of the time tracking.
startDateUtcdatetime or nullOptional

The date (in UTC) when the time tracking was started.

startTimeUtcstring or nullOptional

The time (in UTC) when the time tracking was started.

endDateUtcdatetime or nullOptional

The date (in UTC) when the time tracking was stopped.

endTimeUtcstring or nullOptional

The time (in UTC) when the time tracking was stopped. Required when the time tracking has already been completed and Duration has not been set.

startDateLocaldatetime or nullOptional

The date (in Local) when the time tracking was started.

startTimeLocalstring or nullOptional

The time (in Local) when the time tracking was started.

endDateLocaldatetime or nullOptional

The date (in Local) when the time tracking was stopped.

endTimeLocalstring or nullOptional

The time (in Local) when the time tracking was stopped. Required when the time tracking has already been completed and Duration has not been set.

durationinteger or nullOptional
The duration of the time tracking in seconds. Required when the time tracking has already been completed and EndTime has not been set.
breakDurationinteger or nullOptional
The duration of the break in seconds. Cannot be set via API.
userIdUUID or nullOptional
The id of the user. Can be null if the user was deleted.
idUUIDOptional
The id of the time tracking.
createdByUUIDOptional
The id of the user who created this time tracking.
createdOndatetimeOptional
The date this time tracking was created.
updatedByUUIDOptional
The id of the user who last updated this time tracking.
updatedOndatetimeOptional
The date this time tracking was last modified.
typeOfWorkobjectOptional
userobjectOptional
taskobjectOptional
projectobjectOptional
breakslist of objectsOptional
The breaks of the time tracking.
resourceVersionlongOptional
The version of the entity, updated on every modification, to the ticks in UTC. Not identical to UpdatedOn.
isExternalbooleanOptional

True if this entity is coming from an external workspace (awork Connect).