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

# Update task

`PUT /tasks/{taskId}`

Updates the status of a [VTEX DO](https://help.vtex.com/en/tutorial/vtex-do--7KMbRL4OslN8DTX9oiuCiu) task, filtering by task ID.

## Permissions

This endpoint does not require [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3).

## Path parameters

- `taskId` string, required

## Headers

- `Content-Type` string, required
- `Accept` string, required

## Request body

- object — Task status to be updated.
  - `status` 'Open' | 'Closed' | 'Suspended' | 'InProgress', required — Task status update.

## Response `200`

OK

- unknown

## Changes

- **2025-08-04** `fcdd3eb25f83` — 8 breaking, 3 info
  - removed the enum value `Active` of the request property `status`
  - removed the enum value `Canceled` of the request property `status`
  - removed the enum value `Canceling` of the request property `status`
  - removed the enum value `Deleted` of the request property `status`
  - …7 more
- **2025-07-29** `0f098ad343e4` — 1 info
  - added the new `InProgress` enum value to the request property `status`
- **2025-07-29** `8d57bf80d0bd` — 1 breaking, 8 info
  - request property `status` was restricted to a list of enum values
  - added the new `Active` enum value to the request property `status`
  - added the new `Canceled` enum value to the request property `status`
  - added the new `Canceling` enum value to the request property `status`
  - …5 more
- **2024-06-21** `a297dc0d5d17` — 4 breaking
  - removed the enum value `Closed` of the request property `status`
  - removed the enum value `InProgress` of the request property `status`
  - removed the enum value `Open` of the request property `status`
  - removed the enum value `Suspended` of the request property `status`

[Change history](https://skmtc.dev/vtex/apis/vtex-do-api/changes/tasks/:taskId/put.md)

---

[API](https://skmtc.dev/vtex/apis/vtex-do-api.md) · [All operations](https://skmtc.dev/vtex/apis/vtex-do-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vtex/vtex-do-api/revisions/606bdad07f53/schema)