absenceRegions11

absences5

accounts1

apiUsers5

assignedTasks8

autopilot6

checklistItems16

clientApplications11

companies11

companyFiles15

companyTags6

customFields23

dashboards1

documentComments8

documentFiles15

documents22

documentSpaces11

files2

fileUpload2

filters20

images4

invitations2

permissions3

privateTasks10

projectActivities1

projectAutomations13

projectComments7

projectFiles17

projectMembers2

projectMilestones6

projectMilestoneTemplates5

projectRoles8

projects13

projectStatuses7

projectTags6

projectTasks6

projectTemplateAutomations12

projectTemplateFiles16

projectTemplates14

projectTemplateTags6

projectTypes7

retainers5

roles17

search1

sharedFiles2

taskActivities1

taskBundles29

taskComments7

taskDependencies4

taskDependencyTemplates5

taskFiles16

taskLists13

tasks21

taskSchedules6

taskStatuses5

taskTags9

taskTemplateFiles16

taskTemplates7

taskTemplateTags6

teams9

temporaryFiles6

timeBookings10

timeEntries18

timeReports1

timeTracking8

timeTrackingSettings1

typeOfWork7

userCapacities2

userFiles16

users15

userTags6

webhooks8

workflowAutomations12

workflows21

workload1

workspaceAbsences4

workspaceFiles16

workspaces2

timeTracking

Starts a new time tracking for a user.

If there is already a running/paused time tracking it will be stopped automatically in order to start the new one.

<Check title="Required Permissions" icon="key">The user must be an admin or the creator.</Check>

post/users/{userId}/timetracking/start

Path parameters

userIdstring uuid required

The id of the user.

Headers

Authorizationstring required

Bearer authentication

Request body

isBillableboolean

Whether the time tracking is billable or not.

isBilledboolean

Whether the time tracking is billed or not.

taskIdstring uuid nullable

The id of the task.

projectIdstring uuid nullable

The id of the project.

notestring nullable

The note of the time tracking.

typeOfWorkIdstring uuid required

The id of the type of work of the time tracking.

timezonestring required

The original timezone of the time tracking. The format of the timezone is the IANA standard.

Response

isBillableboolean

Whether the time tracking is billable or not.

isBilledboolean

Whether the time tracking is billed or not.

taskIdstring uuid nullable

The id of the task.

projectIdstring uuid nullable

The id of the project.

notestring nullable

The note of the time tracking.

startDateUtcstring date-time nullable

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

startTimeUtcstring nullable

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

endDateUtcstring date-time nullable

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

endTimeUtcstring nullable

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.

startDateLocalstring date-time nullable

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

startTimeLocalstring nullable

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

endDateLocalstring date-time nullable

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

endTimeLocalstring nullable

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.

timezonestring required

The original timezone of the time tracking. The format of the timezone is the IANA standard.

durationinteger nullable

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

breakDurationinteger nullable

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

typeOfWorkIdstring uuid required

The id of the type of work.

userIdstring uuid nullable

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

idstring uuid

The id of the time tracking.

createdBystring uuid

The id of the user who created this time tracking.

createdOnstring date-time

The date this time tracking was created.

updatedBystring uuid

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

updatedOnstring date-time

The date this time tracking was last modified.

resourceVersioninteger

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

isExternalboolean

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

Changes

Changed in 1 of the 5 revisions of this API.1

Aug 21, 2026a13e7c7042621See the full diff
- ▲
  the timezone request property's minLength was increased from 0 to 1
  request-property-min-length-increased

Full history