Assign the specified clinical task

put/workflowTasks/{taskId}/assignments

Assigns the specified user to the clinical task.

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 clinical task ID, name, and hours worked by the completing user.

The schema for a single user task assignment update.

NameTypeRequiredDescription
assigneeId
string
false

The identifier for the new assignee.

hoursWorked
number
false

The number of hours worked, which is to be updated during this assignment.

taskName
string
false

The name of the associated user task.

Responses

StatusMeaningDescription
200OK

OK - the clinical task was assigned successfully.

Schema
400Bad Request

Bad Request

404Not Found

The clinical task could not be found.