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

# Update a task

`PUT /cmmn-runtime/tasks/{taskId}`

## Request

- Base URL: `https://developer-docs.flowable.com/cmmn-api`
- URL: `https://developer-docs.flowable.com/cmmn-api/cmmn-runtime/tasks/{taskId}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/flowable/apis/flowable-cmmn-rest-api/docs/cmmn-runtime/tasks/:taskId/put.ts> (a function with typed inputs; its response is checked against the schema)

All request values are optional. For example, you can only include the assignee attribute in the request body JSON-object, only updating the assignee of the task, leaving all other fields unaffected. When an attribute is explicitly included and is set to null, the task-value will be updated to null. Example: {"dueDate" : null} will clear the duedate of the task).

## Path parameters

- `taskId` string, required

## Request body

- TaskRequest
  - `owner` string
  - `assignee` string
  - `delegationState` string
  - `name` string
  - `description` string
  - `dueDate` string, date-time
  - `priority` integer
  - `parentTaskId` string
  - `category` string
  - `tenantId` string
  - `formKey` string
  - `ownerSet` boolean
  - `assigneeSet` boolean
  - `delegationStateSet` boolean
  - `nameSet` boolean
  - `descriptionSet` boolean
  - `duedateSet` boolean
  - `prioritySet` boolean
  - `parentTaskIdSet` boolean
  - `categorySet` boolean
  - `tenantIdSet` boolean
  - `formKeySet` boolean

## Response `200`

Indicates the task was updated.

- TaskResponse
  - `id` string
  - `url` string
  - `owner` string
  - `assignee` string
  - `delegationState` string: Delegation-state of the task, can be null, "pending" or "resolved".
  - `name` string
  - `description` string
  - `createTime` string, date-time
  - `dueDate` string, date-time
  - `priority` integer
  - `suspended` boolean
  - `claimTime` string
  - `taskDefinitionKey` string
  - `scopeDefinitionId` string
  - `scopeId` string
  - `subScopeId` string
  - `scopeType` string
  - `propagatedStageInstanceId` string
  - `tenantId` string
  - `category` string
  - `formKey` string
  - `caseInstanceId` string
  - `caseInstanceUrl` string
  - `caseDefinitionId` string
  - `caseDefinitionUrl` string
  - `parentTaskId` string
  - `parentTaskUrl` string
  - `executionId` string
  - `processInstanceId` string
  - `processDefinitionId` string
  - `variables` RestVariable[]
    - `name` string: Name of the variable
    - `type` string: Type of the variable.
    - `value` object: Value of the variable.
    - `valueUrl` string
    - `scope` string

## Other responses

- `404`: Indicates the requested task was not found.
- `409`: Indicates the requested task was updated simultaneously.

---

[API](https://skmtc.dev/flowable/apis/flowable-cmmn-rest-api.md) - [All operations](https://skmtc.dev/flowable/apis/flowable-cmmn-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flowable/apis/flowable-cmmn-rest-api/revisions/afdfa1fcacd0?raw)