Creates a new time entry.

POST

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.

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.

typeOfWorkIdstringRequired

The id of the type of work.

userIdstringRequired

The id of the user.

isBillablebooleanOptionalDefaults to false

Whether the time tracking is billable or not.

isBilledbooleanOptionalDefaults to false

Whether the time tracking is billed or not.

taskIdstringOptional

The id of the task.

projectIdstringOptional

The id of the project.

notestringOptional

The note of the time tracking.

startDateUtcdatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

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

startTimeUtcstringOptional

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

endDateUtcdatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

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

endTimeUtcstringOptional

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.

startDateLocaldatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

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

startTimeLocalstringOptional

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

endDateLocaldatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

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

endTimeLocalstringOptional

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.

durationintegerOptional

The duration of the time tracking in seconds. Required when the time tracking has already been completed and EndTime has not been set.

breakDurationintegerOptional

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.

typeOfWorkIdstring

The id of the type of work.

isBillablebooleanOptionalDefaults to false

Whether the time tracking is billable or not.

isBilledbooleanOptionalDefaults to false

Whether the time tracking is billed or not.

taskIdstringOptional

The id of the task.

projectIdstringOptional

The id of the project.

notestringOptional

The note of the time tracking.

startDateUtcdatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

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

startTimeUtcstringOptional

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

endDateUtcdatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

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

endTimeUtcstringOptional

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.

startDateLocaldatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

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

startTimeLocalstringOptional

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

endDateLocaldatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

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

endTimeLocalstringOptional

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.

durationintegerOptional

The duration of the time tracking in seconds. Required when the time tracking has already been completed and EndTime has not been set.

breakDurationintegerOptional

The duration of the break in seconds. Cannot be set via API.

userIdstringOptional

The id of the user. Can be null if the user was deleted.

idstringOptional

The id of the time tracking.

createdBystringOptional

The id of the user who created this time tracking.

createdOndatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The date this time tracking was created.

updatedBystringOptional

The id of the user who last updated this time tracking.

updatedOndatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The date this time tracking was last modified.

typeOfWorkobjectOptional
userobjectOptional
taskobjectOptional
projectobjectOptional
breakslist of objectsOptional

The breaks of the time tracking.

resourceVersionlongOptionalDefaults to 0

The version of the entity, updated on every modification, to the ticks in UTC. Not identical to UpdatedOn.

isExternalbooleanOptionalDefaults to false

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