Toggle menu

reassignCase

Reassigns a case to another user or group.

Namespace

goss.CaseManagement.v1.api.reassignCase

Worker

serverlibrary

Parameters

Required PropertiesTypeDescription
caseBusinessKeyString <businessKey>The business key of the case
assignGroupNameStringThe name of a user group to assign the case to. No checks are made to see if the group is a valid user group for the case type (or if the group exists)
reasonDescStringA reason for reassigning that will appear in the case history
Optional PropertiesTypeDescription
assignGroupFullStringA user friendly description of the assignGroupName that will appear in the case history
assignUserNameStringThe username of the user the case will be assigned directly to. If both assignUserName and assignGroupName are supplied, assignUserName takes precedence. You must make sure the user exists
noteStringA private note that will be added to the case history
userNameStringIf supplied this user will be recorded as the user who did the reassignment (as the UserId in the case history note). If not supplied this defaults to "system"
debugBooleanDefault: false. Set true to return debug information ("notes") in the response message

Example

See Case Management API for a full example call.

{
    "note": "Reassigning to another team",
    "caseBusinessKey": "0490-1464-3301-8495",
    "assignGroupName": "MANAGERS",
    "reasonDesc": "Escalated"
}

Responses

Success

{
    "jsonrpc": "2.0",
    "id": 207,
    "result": {
        "success": true
    }
}

Error

In this case the business key didn't exist.

{
    "jsonrpc": "2.0",
    "id": 206,
    "result": {
        "success": false,
        "errors": ["CM error: Couldn't find any active executions."]
    }
}

Last modified on 28 April 2026