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

# Update task status

`PATCH /tasks/{taskId}/status`

## Path parameters

- `taskId` string, required

## Request body

- object
  - `status` 'pending' | 'in_progress' | 'completed' | 'cancelled' | 'on_hold', required — Current status of the task

## Response `200`

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