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

# Update a task

`PUT /tasks/{taskId}`

## Path parameters

- `taskId` string, required

## Request body

- UpdateTaskRequest
  - `title` string
  - `description` string
  - `status` 'pending' | 'in_progress' | 'completed' | 'cancelled' | 'on_hold' — Current status of the task
  - `priority` 'low' | 'medium' | 'high' | 'critical' — Priority level of the task
  - `tags` string[]
  - `assigned_to` string
  - `due_date` string, date-time

## Response `200`

Task updated successfully

- Task
  - `id` string, uuid, required — Unique identifier for the task
  - `title` string, required — Title of the task
  - `description` string — Detailed description of the task
  - `status` 'pending' | 'in_progress' | 'completed' | 'cancelled' | 'on_hold', required — Current status of the task
  - `priority` 'low' | 'medium' | 'high' | 'critical', required — Priority level of the task
  - `tags` string[] — Tags associated with the task
  - `created_by` string — User who created the task
  - `assigned_to` string — User currently assigned to the task
  - `created_at` string, date-time, required — When the task was created
  - `updated_at` string, date-time, required — When the task was last updated
  - `due_date` string, date-time — When the task is due
  - `completed_at` string, date-time — When the task was completed

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Resource not found
- `422` — Unprocessable entity
- `500` — Internal server error

---

[API](https://skmtc.net/cloudstreet-dev/apis/task-management-api.md) · [All operations](https://skmtc.net/cloudstreet-dev/apis/task-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudstreet-dev/task-management-api/versions/2f04582e6dc2/schema)