Reassigns a case task. The group/user the task is being reassigned to must be one of those set in the task's configuration.
The user details supplied when reassigning the task should be those of the assigned case manager, or the system user. The system user is defined in the Setup and Naming section of the case configuration and by convention is called CMSYSTEMUSER.
Namespace
goss.CaseManagement.v1.api.caseTask.caseTaskReassign
Worker
serverlibrary
Parameters
| Name | Type | Description |
|---|---|---|
| caseBusinessKey | String | Required. The business key of the parent case |
| caseTaskToReassign | Object | Details of the task to reassign |
| caseTaskToReassign.businessKey | String <business-key> | Required. The business key of the task to reassign |
| caseTaskToReassign.groupId | String | Required. The name of the group (as set in iCM) the case task will be assigned to |
| caseTaskToReassign.groupName | String | Optional. A name for the group to display in the case history notes |
| caseTaskToReassign.userId | String | Optional. The username of the user (as set in iCM) that the task will be assigned to |
| caseTaskToReassign.userName | String | Optional. A name for the user to display in the case history notes |
| caseTaskToReassign.notes | String | Optional notes that will appear in the case history |
| user | Object | Required. Details of the user reassigning the task. This must be the current case manager, or the system user if the case is unclaimed |
| user.displayName | String | Optional. A name to use in the case history notes |
| user.siteUserName | String | Required. The username as set in iCM |
| proxyUser | Object | Optional. Details of the user being proxied (eg this could be the system user, while the user is the actual user) |
| proxyUser.displayName | String | Optional. A name to use in the case history notes |
| proxyUser.siteUserName | String | Required. The username as set in iCM |
| trackProgress | Boolean | Optional. If true the reassignment will be performed asynchronously with updates being written to a tracking sessions |
Example
See Case Management API for the full example call structure.
{
"caseBusinessKey": "9770-3153-1627-4765",
"caseTaskToReassign": {
"businessKey": "3104-5017-2730-1176",
"groupId": "CM-ALLOTMENTENQUIRIES",
"groupName": "Allotment Team",
"userId": "F94C0490-6204-4873-BC70-98656FB4D3FE",
"userName": "Tim",
"notes": "Reassign due to workload"
},
"user": {
"displayName": "Team lead",
"siteUserName": "FGFG464526-DFHSDJSJ-256267"
},
"trackProgress": false
}
Return Schema
| Name | Type | Description |
|---|---|---|
| success | Boolean | Required |
| complete | Boolean | Optional |
| startTime | String | Optional |
| duration | Number | Optional |
| endTime | String | Optional |
| progressTrackingSessionId | String | Optional |
| errors | Array <object> | Optional |
| updatedTask | Object | Optional. Details of the reassigned task |
| debug | Array <object> | Optional |
| warnings | Array <object> | Optional |
Example
{
"id": 41,
"result": {
"success": true,
"complete": true,
"startTime": "2026-03-26T08:34:20.336Z",
"endTime": "2026-03-26T08:34:21.909Z",
"duration": 1573,
"debug": [{
"message": "Claiming task 50492581 for user timg",
"data": {}
}],
"updatedTask": {
"summary": "Email Conversation",
"groupName": "groupName",
"raised": "2026-03-26T08:20:53.399Z",
"taskType": "emailconversation71",
"businessKey": "3104-5017-2730-1176",
"processName": "cmemailconversationv1",
"taskName": "Email Conversation",
"taskID": 3,
"id": "3104-5017-2730-1176",
"showReadOnly": false,
"groupID": "CM-ALLOTMENTENQUIRIES",
"formEnquiry": "CASEMANAGEMENTEMAILCONVERSATIONENQUIRYVIEWV1EN",
"details": "Email Conversation",
"updated": "2026-03-26T08:34:21.906Z",
"created": "2026-03-26T08:20:53.399Z",
"showAttachments": "",
"permissions": {
"canCancel": false,
"canView": true,
"canReassign": true
},
"userName": "My username",
"attachments": {
"allAttachments": false,
"showAttachments": ""
},
"allAttachments": false,
"status": "New",
"lastUpdated": "2026-03-26T08:33:37.229Z",
"userID": "timg",
"taskStatus": {
"code": "New",
"description": "New",
"statusDescs": {
"escalated": "Escalated",
"error": "Error",
"start": "New",
"cancelled": "Cancelled",
"inProgress": ["Open"],
"end": "Closed"
},
"statusList": {
"escalated": "Escalated",
"error": "Error",
"start": "New",
"cancelled": "Cancelled",
"inProgress": ["Open"],
"end": "Closed"
}
},
"started": "2026-03-26T08:20:53.399Z",
"cancellable": false,
"statusDesc": "New"
}
},
"jsonrpc": "2.0"
}
