---
title: "Update a task"
method: PUT
path: "/v1/tasks/{taskId}"
tags: ["Personal Tasks"]
---

# Update a task

`PUT /v1/tasks/{taskId}`

Update a task by its ID

## Path parameters

- `taskId` integer, required

## Headers

- `X-Org-Id` integer, required

## Request body

- TaskUpdateRequest — DTO for updating an existing task. This object is used to transfer data from the client to the server when updating a task.
  - `taskTitle` string — Title of the task. Optional for updates.
  - `description` string — Description of the task. Optional for updates.
  - `owners` integer[] — List of owner IDs assigned to the task. Optional for updates.
  - `startDate` string, date-time — Start date of the task. Optional for updates.
  - `dueDate` string, date-time — Due date of the task. Optional for updates.
  - `noOfDays` integer — Duration in working days. When sent together with startDate or dueDate, the missing date is recomputed honouring the organisation's operational hours.
  - `completion` integer — Completion percentage of the task. Must be between 0 and 100. Optional for updates.
  - `status` string — Status of the task. Optional for updates.
  - `priority` string — Priority of the task. Optional for updates.
  - `tags` string[] — List of tags associated with the task. Optional for updates.

## Response `200`

Task updated successfully

---

[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)