---
title: "Add manual time entry for a task"
method: POST
path: "/v1/time-track/tasks/{taskId}/manual"
tags: ["Task Timer"]
---

# Add manual time entry for a task

`POST /v1/time-track/tasks/{taskId}/manual`

Adds a manual time entry to a task with hours, minutes, start time, billing info, and optional notes.

## Path parameters

- `taskId` integer, required

## Headers

- `X-Org-Id` integer, required

## Request body

- ManualTimerRequest — Payload to add manual time entry for a task. Includes duration, start time, billing info, and optional notes.
  - `hours` integer, required — Hours to be logged manually
  - `minutes` integer, required — Minutes to be logged manually
  - `startTime` integer, required — Epoch timestamp indicating when the task work started
  - `billingType` boolean, required — Whether the logged time is billable
  - `notes` string — Optional notes describing the work done

## Response `200`

Manual time added successfully

- ApiSuccessResponseTimeTrackerDto — Standard API success response structure
  - `success` boolean — Indicates if the operation was successful
  - `message` string — Message describing the result of the operation
  - `code` integer — HTTP status code of the response
  - `data` TimeTrackerDto
    - `tenantId` integer
    - `trackId` integer
    - `trackerType` string
    - `startTime` string, date-time
    - `endTime` string, date-time
    - `timePeriod` integer
    - `taskId` integer
    - `parentTaskId` integer
    - `title` string
    - `projectId` integer
    - `spaceId` integer
    - `billingType` boolean
    - `notes` string
    - `user` UserMinimalDto
      - `userId` integer
      - `firstName` string
      - `email` string
      - `profilePicURL` string
      - `profilePicColor` string
      - `provider` string
      - `role` OrgRoleDto
        - `orgRoleId` integer
        - `roleName` string
    - `createdTime` string, date-time
    - `when` string, date-time
    - `status` string
  - `timestamp` string, date-time — Timestamp of the response

---

[API](https://skmtc.net/astravue/apis/astravue-api.md) · [All operations](https://skmtc.net/astravue/apis/astravue-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astravue/astravue-api/versions/237f5bbd4029/schema)
