--- title: "Start a new timer" method: POST path: "/v1/timer/start" tags: ["Timer"] --- # Start a new timer `POST /v1/timer/start` Starts a new timing session for the authenticated user on the specified project. Creates a new task for the timer and sets the timer to running state. Returns the updated timer information. ## Request body - TimerStartDto - `projectId` string - `startDateTime` string - `valid` boolean ## Response `200` Timer started successfully - TimerDto - `id` string - `status` string - `user` string - `task` TaskDto - `id` string - `user` string - `deleted` boolean - `running` boolean - `lastUpdate` integer - `created` integer - `description` string - `location` string - `locationEnd` string - `startDateTime` string - `endDateTime` string - `feeling` integer - `typeId` integer - `paid` boolean - `billed` boolean - `billable` boolean - `phoneNumber` string - `distance` string, decimal - `signature` string - `project` ProjectDto - `id` string - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `title` string - `description` string - `employer` string - `office` string - `color` integer - `taskDefaultBillable` boolean - `archived` boolean - `salaryVisibility` integer - `salary` string, decimal - `team` TeamDto - `id` string - `organization` OrganizationDto - `id` string - `name` string - `description` string - `image` string - `color` integer - `subscription` CustomerSubscriptionDto - `id` string - `user` string - `expires` integer - `status` integer - `plan` integer - `licenses` integer - `paymentOption` string - `business` string - `email` string - `firstname` string - `lastname` string - `vatId` string - `displayName` string - `street` string - `city` string - `state` string - `zip` string - `country` string - `countryIso` string - `language` string - `includeTaxForBusiness` boolean - `activated` boolean - `pastDue` boolean - `cancellationOffer` boolean - `subscriptionActive` boolean - `subscriptionCancelled` boolean - `subscriptionInactive` boolean - `paymentProviderActive` boolean - `startedTestimonial` string, date-time - `activationDate` string, date-time - `cancellationDate` string, date-time - `permissionAdmin` boolean - `valid` boolean - `expired` boolean - `validAndActivated` boolean - `payPalPayment` boolean - `stripePayment` boolean - `invoicePayment` boolean - `googlePlayPayment` boolean - `appleStorePayment` boolean - `currency` string - `businessCustomer` boolean - `euCustomer` boolean - `eu` boolean - `at` boolean - `ch` boolean - `uk` boolean - `product` string - `licenseQuantity` integer - `active` boolean - `trial` boolean - `cancelled` boolean - `member` boolean - `businessOrTrial` boolean - `pro` boolean - `planEnterprise` boolean - `planBusiness` boolean - `planPro` boolean - `planPlus` boolean - `planBasic` boolean - `monthlyPlan` boolean - `yearlyPlan` boolean - `organization` boolean - `user` string - `aiChatEnabled` boolean - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` OrganizationPermissionDto - `invoicing` boolean - `billing` boolean - `admin` boolean - `organizationId` string - `name` string - `description` string - `image` string - `color` integer - `projectSalaryVisibility` integer - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` TeamPermissionDto - `role` string - `manager` boolean - `owner` boolean - `member` boolean - `managerOrOwner` boolean - `projects` integer - `members` integer - `projectSalaryVisible` boolean - `permission` ProjectPermissionDto - `role` string - `manager` boolean - `owner` boolean - `member` boolean - `managerOrOwner` boolean - `duration` integer - `durationBreak` integer - `salaryTotal` string, decimal - `salaryBreak` string, decimal - `expenses` string, decimal - `expensesPaid` string, decimal - `mileage` string, decimal - `todoEstimatedDuration` integer - `todoTrackedDuration` integer - `todoCount` integer - `titleAndClient` string - `salaryVisible` boolean - `todo` ToDoDto - `id` string - `user` string - `deleted` boolean - `lastUpdate` integer - `created` integer - `project` ProjectDto - `id` string - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `title` string - `description` string - `employer` string - `office` string - `color` integer - `taskDefaultBillable` boolean - `archived` boolean - `salaryVisibility` integer - `salary` string, decimal - `team` TeamDto - `id` string - `organization` OrganizationDto - `id` string - `name` string - `description` string - `image` string - `color` integer - `subscription` CustomerSubscriptionDto - … - `user` string - `aiChatEnabled` boolean - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` OrganizationPermissionDto - … - `organizationId` string - `name` string - `description` string - `image` string - `color` integer - `projectSalaryVisibility` integer - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` TeamPermissionDto - `role` string - `manager` boolean - `owner` boolean - `member` boolean - `managerOrOwner` boolean - `projects` integer - `members` integer - `projectSalaryVisible` boolean - `permission` ProjectPermissionDto - `role` string - `manager` boolean - `owner` boolean - `member` boolean - `managerOrOwner` boolean - `duration` integer - `durationBreak` integer - `salaryTotal` string, decimal - `salaryBreak` string, decimal - `expenses` string, decimal - `expensesPaid` string, decimal - `mileage` string, decimal - `todoEstimatedDuration` integer - `todoTrackedDuration` integer - `todoCount` integer - `titleAndClient` string - `salaryVisible` boolean - `name` string - `description` string - `status` integer - `dueDate` string - `assignedUsers` string - `assignedMembers` Member[] - `uid` string - `firstname` string - `lastname` string - `email` string - `employeeId` string - `imageUrl` string - `deleted` boolean - `activity` Activity - `projectId` string - `projectTitle` string - `projectColor` integer - `taskId` string - `startDateTime` string - `endDateTime` string - `location` string - `running` boolean - `displayName` string - `initials` string - `estimatedHours` integer - `estimatedMinutes` integer - `duration` integer - `durationBreak` integer - `salaryTotal` string, decimal - `salaryBreak` string, decimal - `expenses` string, decimal - `expensesPaid` string, decimal - `mileage` string, decimal - `progress` number, double - `rate` RateDto - `id` string - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `title` string - `factor` string, decimal - `extra` string, decimal - `enabled` boolean - `archived` boolean - `team` TeamDto - `id` string - `organization` OrganizationDto - `id` string - `name` string - `description` string - `image` string - `color` integer - `subscription` CustomerSubscriptionDto - `id` string - `user` string - `expires` integer - `status` integer - `plan` integer - `licenses` integer - `paymentOption` string - `business` string - `email` string - `firstname` string - `lastname` string - `vatId` string - `displayName` string - `street` string - `city` string - `state` string - `zip` string - `country` string - `countryIso` string - `language` string - `includeTaxForBusiness` boolean - `activated` boolean - `pastDue` boolean - `cancellationOffer` boolean - `subscriptionActive` boolean - `subscriptionCancelled` boolean - `subscriptionInactive` boolean - `paymentProviderActive` boolean - `startedTestimonial` string, date-time - `activationDate` string, date-time - `cancellationDate` string, date-time - `permissionAdmin` boolean - `valid` boolean - `expired` boolean - `validAndActivated` boolean - `payPalPayment` boolean - `stripePayment` boolean - `invoicePayment` boolean - `googlePlayPayment` boolean - `appleStorePayment` boolean - `currency` string - `businessCustomer` boolean - `euCustomer` boolean - `eu` boolean - `at` boolean - `ch` boolean - `uk` boolean - `product` string - `licenseQuantity` integer - `active` boolean - `trial` boolean - `cancelled` boolean - `member` boolean - `businessOrTrial` boolean - `pro` boolean - `planEnterprise` boolean - `planBusiness` boolean - `planPro` boolean - `planPlus` boolean - `planBasic` boolean - `monthlyPlan` boolean - `yearlyPlan` boolean - `organization` boolean - `user` string - `aiChatEnabled` boolean - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` OrganizationPermissionDto - `invoicing` boolean - `billing` boolean - `admin` boolean - `organizationId` string - `name` string - `description` string - `image` string - `color` integer - `projectSalaryVisibility` integer - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` TeamPermissionDto - `role` string - `manager` boolean - `owner` boolean - `member` boolean - `managerOrOwner` boolean - `projects` integer - `members` integer - `projectSalaryVisible` boolean - `member` Member - `uid` string - `firstname` string - `lastname` string - `email` string - `employeeId` string - `imageUrl` string - `deleted` boolean - `activity` Activity - `projectId` string - `projectTitle` string - `projectColor` integer - `taskId` string - `startDateTime` string - `endDateTime` string - `location` string - `running` boolean - `displayName` string - `initials` string - `invoiceId` string - `tags` TagDto[] - `id` string - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `name` string - `color` integer - `archived` boolean - `team` TeamDto - `id` string - `organization` OrganizationDto - `id` string - `name` string - `description` string - `image` string - `color` integer - `subscription` CustomerSubscriptionDto - `id` string - `user` string - `expires` integer - `status` integer - `plan` integer - `licenses` integer - `paymentOption` string - `business` string - `email` string - `firstname` string - `lastname` string - `vatId` string - `displayName` string - `street` string - `city` string - `state` string - `zip` string - `country` string - `countryIso` string - `language` string - `includeTaxForBusiness` boolean - `activated` boolean - `pastDue` boolean - `cancellationOffer` boolean - `subscriptionActive` boolean - `subscriptionCancelled` boolean - `subscriptionInactive` boolean - `paymentProviderActive` boolean - `startedTestimonial` string, date-time - `activationDate` string, date-time - `cancellationDate` string, date-time - `permissionAdmin` boolean - `valid` boolean - `expired` boolean - `validAndActivated` boolean - `payPalPayment` boolean - `stripePayment` boolean - `invoicePayment` boolean - `googlePlayPayment` boolean - `appleStorePayment` boolean - `currency` string - `businessCustomer` boolean - `euCustomer` boolean - `eu` boolean - `at` boolean - `ch` boolean - `uk` boolean - `product` string - `licenseQuantity` integer - `active` boolean - `trial` boolean - `cancelled` boolean - `member` boolean - `businessOrTrial` boolean - `pro` boolean - `planEnterprise` boolean - `planBusiness` boolean - `planPro` boolean - `planPlus` boolean - `planBasic` boolean - `monthlyPlan` boolean - `yearlyPlan` boolean - `organization` boolean - `user` string - `aiChatEnabled` boolean - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` OrganizationPermissionDto - `invoicing` boolean - `billing` boolean - `admin` boolean - `organizationId` string - `name` string - `description` string - `image` string - `color` integer - `projectSalaryVisibility` integer - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` TeamPermissionDto - `role` string - `manager` boolean - `owner` boolean - `member` boolean - `managerOrOwner` boolean - `projects` integer - `members` integer - `projectSalaryVisible` boolean - `totalTime` integer - `pauses` PauseDto[] - `id` string - `user` string - `deleted` boolean - `running` boolean - `lastUpdate` integer - `created` integer - `description` string - `startDateTime` string - `endDateTime` string - `task` TaskDto — recursive - `member` Member - `uid` string - `firstname` string - `lastname` string - `email` string - `employeeId` string - `imageUrl` string - `deleted` boolean - `activity` Activity - `projectId` string - `projectTitle` string - `projectColor` integer - `taskId` string - `startDateTime` string - `endDateTime` string - `location` string - `running` boolean - `displayName` string - `initials` string - `expenses` ExpenseDto[] - `id` string - `user` string - `deleted` boolean - `lastUpdate` integer - `created` integer - `description` string - `dateTime` string - `amount` string, decimal - `refunded` boolean - `fileUri` string - `fileName` string - `task` TaskDto — recursive - `member` Member - `uid` string - `firstname` string - `lastname` string - `email` string - `employeeId` string - `imageUrl` string - `deleted` boolean - `activity` Activity - `projectId` string - `projectTitle` string - `projectColor` integer - `taskId` string - `startDateTime` string - `endDateTime` string - `location` string - `running` boolean - `displayName` string - `initials` string - `invoiceId` string - `notes` NoteDto[] - `id` string - `user` string - `deleted` boolean - `lastUpdate` integer - `created` integer - `text` string - `dateTime` string - `uri` string - `driveId` string - `task` TaskDto — recursive - `member` Member - `uid` string - `firstname` string - `lastname` string - `email` string - `employeeId` string - `imageUrl` string - `deleted` boolean - `activity` Activity - `projectId` string - `projectTitle` string - `projectColor` integer - `taskId` string - `startDateTime` string - `endDateTime` string - `location` string - `running` boolean - `displayName` string - `initials` string - `duration` integer - `durationBreak` integer - `salaryTotal` string, decimal - `salaryBreak` string, decimal - `expensesTotal` string, decimal - `expensesPaid` string, decimal - `expensesCount` integer - `expensesPaidCount` integer - `mileage` string, decimal - `notesTotal` integer - `salaryVisible` boolean - `pause` PauseDto - `id` string - `user` string - `deleted` boolean - `running` boolean - `lastUpdate` integer - `created` integer - `description` string - `startDateTime` string - `endDateTime` string - `task` TaskDto - `id` string - `user` string - `deleted` boolean - `running` boolean - `lastUpdate` integer - `created` integer - `description` string - `location` string - `locationEnd` string - `startDateTime` string - `endDateTime` string - `feeling` integer - `typeId` integer - `paid` boolean - `billed` boolean - `billable` boolean - `phoneNumber` string - `distance` string, decimal - `signature` string - `project` ProjectDto - `id` string - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `title` string - `description` string - `employer` string - `office` string - `color` integer - `taskDefaultBillable` boolean - `archived` boolean - `salaryVisibility` integer - `salary` string, decimal - `team` TeamDto - `id` string - `organization` OrganizationDto - `id` string - `name` string - `description` string - `image` string - `color` integer - `subscription` CustomerSubscriptionDto - … - `user` string - `aiChatEnabled` boolean - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` OrganizationPermissionDto - … - `organizationId` string - `name` string - `description` string - `image` string - `color` integer - `projectSalaryVisibility` integer - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` TeamPermissionDto - `role` string - `manager` boolean - `owner` boolean - `member` boolean - `managerOrOwner` boolean - `projects` integer - `members` integer - `projectSalaryVisible` boolean - `permission` ProjectPermissionDto - `role` string - `manager` boolean - `owner` boolean - `member` boolean - `managerOrOwner` boolean - `duration` integer - `durationBreak` integer - `salaryTotal` string, decimal - `salaryBreak` string, decimal - `expenses` string, decimal - `expensesPaid` string, decimal - `mileage` string, decimal - `todoEstimatedDuration` integer - `todoTrackedDuration` integer - `todoCount` integer - `titleAndClient` string - `salaryVisible` boolean - `todo` ToDoDto - `id` string - `user` string - `deleted` boolean - `lastUpdate` integer - `created` integer - `project` ProjectDto - `id` string - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `title` string - `description` string - `employer` string - `office` string - `color` integer - `taskDefaultBillable` boolean - `archived` boolean - `salaryVisibility` integer - `salary` string, decimal - `team` TeamDto - `id` string - `organization` OrganizationDto - … - `organizationId` string - `name` string - `description` string - `image` string - `color` integer - `projectSalaryVisibility` integer - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` TeamPermissionDto - … - `projects` integer - `members` integer - `projectSalaryVisible` boolean - `permission` ProjectPermissionDto - `role` string - `manager` boolean - `owner` boolean - `member` boolean - `managerOrOwner` boolean - `duration` integer - `durationBreak` integer - `salaryTotal` string, decimal - `salaryBreak` string, decimal - `expenses` string, decimal - `expensesPaid` string, decimal - `mileage` string, decimal - `todoEstimatedDuration` integer - `todoTrackedDuration` integer - `todoCount` integer - `titleAndClient` string - `salaryVisible` boolean - `name` string - `description` string - `status` integer - `dueDate` string - `assignedUsers` string - `assignedMembers` Member[] - `uid` string - `firstname` string - `lastname` string - `email` string - `employeeId` string - `imageUrl` string - `deleted` boolean - `activity` Activity - `projectId` string - `projectTitle` string - `projectColor` integer - `taskId` string - `startDateTime` string - `endDateTime` string - `location` string - `running` boolean - `displayName` string - `initials` string - `estimatedHours` integer - `estimatedMinutes` integer - `duration` integer - `durationBreak` integer - `salaryTotal` string, decimal - `salaryBreak` string, decimal - `expenses` string, decimal - `expensesPaid` string, decimal - `mileage` string, decimal - `progress` number, double - `rate` RateDto - `id` string - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `title` string - `factor` string, decimal - `extra` string, decimal - `enabled` boolean - `archived` boolean - `team` TeamDto - `id` string - `organization` OrganizationDto - `id` string - `name` string - `description` string - `image` string - `color` integer - `subscription` CustomerSubscriptionDto - … - `user` string - `aiChatEnabled` boolean - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` OrganizationPermissionDto - … - `organizationId` string - `name` string - `description` string - `image` string - `color` integer - `projectSalaryVisibility` integer - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` TeamPermissionDto - `role` string - `manager` boolean - `owner` boolean - `member` boolean - `managerOrOwner` boolean - `projects` integer - `members` integer - `projectSalaryVisible` boolean - `member` Member - `uid` string - `firstname` string - `lastname` string - `email` string - `employeeId` string - `imageUrl` string - `deleted` boolean - `activity` Activity - `projectId` string - `projectTitle` string - `projectColor` integer - `taskId` string - `startDateTime` string - `endDateTime` string - `location` string - `running` boolean - `displayName` string - `initials` string - `invoiceId` string - `tags` TagDto[] - `id` string - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `name` string - `color` integer - `archived` boolean - `team` TeamDto - `id` string - `organization` OrganizationDto - `id` string - `name` string - `description` string - `image` string - `color` integer - `subscription` CustomerSubscriptionDto - … - `user` string - `aiChatEnabled` boolean - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` OrganizationPermissionDto - … - `organizationId` string - `name` string - `description` string - `image` string - `color` integer - `projectSalaryVisibility` integer - `user` string - `lastUpdate` integer - `created` integer - `deleted` boolean - `permission` TeamPermissionDto - `role` string - `manager` boolean - `owner` boolean - `member` boolean - `managerOrOwner` boolean - `projects` integer - `members` integer - `projectSalaryVisible` boolean - `totalTime` integer - `pauses` PauseDto[] - `expenses` ExpenseDto[] - `id` string - `user` string - `deleted` boolean - `lastUpdate` integer - `created` integer - `description` string - `dateTime` string - `amount` string, decimal - `refunded` boolean - `fileUri` string - `fileName` string - `task` TaskDto — recursive - `member` Member - `uid` string - `firstname` string - `lastname` string - `email` string - `employeeId` string - `imageUrl` string - `deleted` boolean - `activity` Activity - `projectId` string - `projectTitle` string - `projectColor` integer - `taskId` string - `startDateTime` string - `endDateTime` string - `location` string - `running` boolean - `displayName` string - `initials` string - `invoiceId` string - `notes` NoteDto[] - `id` string - `user` string - `deleted` boolean - `lastUpdate` integer - `created` integer - `text` string - `dateTime` string - `uri` string - `driveId` string - `task` TaskDto — recursive - `member` Member - `uid` string - `firstname` string - `lastname` string - `email` string - `employeeId` string - `imageUrl` string - `deleted` boolean - `activity` Activity - `projectId` string - `projectTitle` string - `projectColor` integer - `taskId` string - `startDateTime` string - `endDateTime` string - `location` string - `running` boolean - `displayName` string - `initials` string - `duration` integer - `durationBreak` integer - `salaryTotal` string, decimal - `salaryBreak` string, decimal - `expensesTotal` string, decimal - `expensesPaid` string, decimal - `expensesCount` integer - `expensesPaidCount` integer - `mileage` string, decimal - `notesTotal` integer - `salaryVisible` boolean - `member` Member - `uid` string - `firstname` string - `lastname` string - `email` string - `employeeId` string - `imageUrl` string - `deleted` boolean - `activity` Activity - `projectId` string - `projectTitle` string - `projectColor` integer - `taskId` string - `startDateTime` string - `endDateTime` string - `location` string - `running` boolean - `displayName` string - `initials` string - `lastUpdate` integer - `created` integer - `paused` boolean - `running` boolean - `stopped` boolean ## Other responses - `400` — Bad request - Timer already running or invalid parameters - `401` — User is not authenticated - `403` — User doesn't have permission to start a timer for this project - `500` — Internal server error --- [API](https://skmtc.net/timesheet/apis/timesheet-api.md) · [All operations](https://skmtc.net/timesheet/apis/timesheet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timesheet/timesheet-api/versions/fbe59bacb638/schema)