Add case note

Description

This service allows an authenticated operator or party to add a new comment (note) to an existing case.

---

Request

Restrictions

• Authentication: Requires a successful operator or party login.

• Authorization: The request will fail if the authenticated user or touchpoint does not have permission to add notes to the specific case.

Endpoint

POST https://<server-url>/api/v4/cases/{case_id}/notes

Path Parameters

Parameter	Type	Description
case_id	Integer	The unique ID of the case to which the comment will be added.

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 contains the text of the note to be added.

Field	Type	Description
description	String	Required. The content of the comment or note.

Example Body:

{  
   "description": "This is a note!" 
}

---

Response

✅ Successful Response: 201 Created

The comment was successfully added. The response returns the session context and the newly created comment object.

JSON

{  
   "context": {  
      "simpleProfile": {  
         "firstname": "test",
         "lastname": "test",
         "email": "[email protected]"
      }
   },
   "comment": {  
      "caseInstanceId": 1,
      "description": "This is a note!"
   }
}

---

❌ Unsuccessful Response

400 Bad Request

Error Code	Description
invalidId	The case_id provided does not exist, or the authenticated operator/touchpoint is not authorized to add notes to this specific case.