Assign case

Description

This service allows an operator to assign a case to another specific operator (via email) or to a defined operator group (via group name).

---

Request

Restrictions

• Authentication: Requires a successful operator login.

• Mutual Exclusivity: Both an email and a groupName can't be provided in the same request. A single one must be chosen and sent as an identifier.

Endpoint

PUT https://<server-url>/api/v4/cases/{caseInstanceId}/assignment

Path Parameters

Parameter	Type	Description
caseInstanceId	Integer	The unique ID of the case instance to be assigned.

Parameters

Parameter	Location	Description
touchpoint	Query / Header	The identifier for the touchpoint. Use Thalamus-Touchpoint for the header.
token	Query / Header	The authentication token for the API session. Use Thalamus-Token for the header.
Content-Type	Header	Must be application/json.

Request Body

The body must contain either the email of the target operator or the groupName of the target group.

Field	Type	Description
email	String	The email address of the operator to whom the case will be assigned.
groupName	String	The name of the case operator group to which the case will be assigned.

Example 1: Assign to Operator

{   
 "email": "[email protected]"
}

Example 2: Assign to Group

{   
 "groupName": "Local Support"
}

---

Response

✅ Successful Response: 201 Created

The assignment was successful. The response returns the session context and the case object.

JSON

{  
   "context": {  
      "simpleProfile": {  
         "firstname": "test",
         "email": "[email protected]"
      }
   },
   "case": {  
      "id": 10,
      "categoryCode": "Reclamo", 
      "typeCode": "Telefonico", 
      "status": "resolved",
      "resolution": "Tecnica"
   }
}

---

❌ Unsuccessful Response

400 Bad Request

Error Code	Description
invalidId	The caseInstanceId is invalid, or the authenticated operator/touchpoint is not authorized.
operatorNotValid	The operator associated with the provided email does not exist or is invalid.
invalidName	The provided groupName does not exist.
isNotAuthorized	The target operator is not authorized to handle this specific case type.
blocked	The target operator is currently blocked in the system.
invalid	Both email and groupName were sent; they are mutually exclusive.
missing	Neither email nor groupName was provided in the request body.