Update the specified clinical task

patch/workflowTasks/{taskId}

Updates the specified clinical task with the values specified.

Request Samples

Response Samples

1{
2 "value": {
3 "version": 1,
4 "id": "WF195a938b-c6c4-464f-8999-d092b513edd1",
5 "name": "Data setup",
6 "elementId": "data_setup",
7 "contextId": "32a2a9fe-ba73-42d6-a9cd-1dda251cf441",
8 "contextTypeId": "organization",
9 "contextPath": "/Org",
10 "workflowId": "30ac3aee-b128-4b87-8c06-e1a68a4486ee",
11 "workflowName": "Data Validation",
12 "assigneeId": "sastest1",
13 "assigneeDisplayName": "SAS Test User 1 (sastest1)",
14 "priority": "LOW",
15 "taskDueTimeStamp": "2025-09-30T21:43:11.151Z",
16 "creationTimeStamp": "2025-09-30T17:43:11.169Z"
17 }
18}

Path Parameters

NameTypeRequiredDescription
taskId
string
true

The unique identifier for the clinical workflow task.

Request Body

The values to set for the specified clinical task.

The schema for updating a single user task.

NameTypeRequiredDescription
name
string
false

The name to set for the user task.

description
string
false

The description to set for the user task.

assigneeId
string
false

The identifier for the assignee to set for the user task.

priority
string
false

The priority to set for the user task. Possible values are 'ALERT', 'HIGH', 'MEDIUM', and 'LOW'.

hoursWorked
number<double>
false

The hours worked for the current assignee. If the assignee is changed during the update, this value is stored in the associated assignment history.

taskDueTimeStamp
string<date-time>
false

The due date to set for the clinical task.

candidates
array [string]
false

The IDs for the candidates of the clinical task.

completionData
array [Clinical Workflow Variable Value]
false

Specifies the names and values of the clinical workflow variables to update.

Responses

StatusMeaningDescription
200OK

OK - the clinical task was updated successfully.

Schema
400Bad Request

Bad Request

404Not Found

The clinical task could not be found.