---
title: "POST /workflowtasks/{taskId}/change-task-status"
method: POST
path: "/workflowtasks/{taskId}/change-task-status"
tags: ["WorkflowTasks"]
---

# POST /workflowtasks/{taskId}/change-task-status

`POST /workflowtasks/{taskId}/change-task-status`

Update the status of a workflow task request.

## Path parameters

- `taskId` string, uuid, required

## Query parameters

- `api-version` string, required

## Request body

- TaskUpdateCommand
  - `newStatus` 'NotStarted' | 'InProgress' | 'Completed' | 'Canceled', required — The new status will be used to update the task.
  - `comment` string — The comment when update a task.

## Response `200`

OK

## Other responses

- `default` — Error response describing why the operation failed.

## Changes

- **2026-07-13** (2022-05-01-preview) `60435bfd503d` — 1 info
  - api operation id `UpdateTaskStatus` removed and replaced with `TaskStatus_Update`

[Change history](https://skmtc.dev/azure/apis/purview-workflow/changes/workflowtasks/:taskId/change-task-status/post.md)

---

[API](https://skmtc.dev/azure/apis/purview-workflow.md) · [All operations](https://skmtc.dev/azure/apis/purview-workflow/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/purview-workflow/revisions/60435bfd503d/schema)