Description

This endpoint will allow you to reply to a Hi Marley case note. This endpoint supports the ability to tag operators in case notes. For more information about case notes, please visit this page: Hi Marley - Case Notes

Service Name	Reply to Note
Service Type	REST
Method	POST
UAT (Sandbox) URL	https://integration.uat.marley.ai/api/v2/cases/:caseId/notes/:noteId/replies
Production URL	https://integration.himarley.io/api/v2/cases/:caseId/notes/:noteId/replies
Technical Documentation	View technical documentation with sample request and response payloads hosted on Postman.

- API Request
- API Response
  - Response Payload Example
  - Response Body Breakdown

API Request

Flow

Send API request with the path parameters of the Hi Marley Case ID and the case note Note ID
- The Note ID will indicate which case note for which this reply is intended
Include "noteText" and "author" in the request body
Hi Marley receives the request and validates the Case ID and Note ID exist
Hi Marley creates case note with note text and author from body

Tagging Operators via API

This endpoint supports tagging operators, similar to the Hi Marley webapp. To tag operators, add the user's email to the noteText field in the request body with the @ symbol before an array containing the email address, such as @[example@tester.com]. The email address must match the email stored within the Hi Marley webapp.

Request Path Example

https://integration.uat.marley.ai/api/case/c808ba82-e2cb-4a92-9344-b924d79d2308/
notes/3195e5bd-0a8b-4684-a9de-745e77cc38c4/replies

Request Body Example

{
"noteText": "Hello @[testuser@example.com] did you have a question for me?",
"taggedUsers": ["testuser@example.com"],
"author": "adjuster@example.com"
}

Request Path Breakdown

Property	Values	Description	Type	Required	Example	Validation
caseId		The Case ID associated with the Hi Marley case	string	true	c808ba82-e2cb-4a92-9344-b924d79d2308	caseId exists within Hi Marley
noteId		The Note ID associated with the notes to which the operator is responding within the Hi Marley case	string	true	3195e5bd-0a8b-4684-a9de-745e77cc38c4	noteId exists within Hi Marley

Request Body Breakdown

Property	Element	Description	Type	Required	Example
noteText		The body of the note to be included in the request. Any tagged user	string	true	"noteText": "Hello, how are you @[testuser@example.com]?"
author	email	Author of the note being passed by the API, should be the operator's email address	string	true	"author": "adjuster@example.com"
taggedUsers	email	Email address of an users tagged in the message body	array	false	"taggedUsers": ["testuser@example.com"]

API Response

Response Payload Example

{
    "archived": false,
    "mentionedUserIds": [
        "5bfa662f-2026-4bfa-be39-57a8ae7b083f"
    ],
    "authorId": "643bb2f8-f82d-4e71-94f0-fad78172024a",
    "plainText": "Hello @ExampleUser",
    "replies": [
       {
         "archived": false,
         "mentionedUserIds": [
         "643bb2f8-f82d-4e71-94f0-fad78172024a"
               ],
         "authorId": "5bea662f-2026-4bfa-be39-57a9ae6b083f",
         "plainText": "Hello @KevinRoller this is a test (again)",
         "id": "1b6e5320-db96-459a-b473-26e6a71228b1"
        }
           ],
    "id": "05b620d7-d4f6-46fa-b1d0-ede778b0fd99"
}

Response Body Breakdown

The response body of the Case Note Reply API endpoint is that the majority of the response body will return information for the original note, while the reply created via this request will appears in the "replies" field. See below for more information. The properties both in the original note and the replies will match.

Property	Element	Description	Type	Example
archived		Indicates whether the note has been archived or not. Will be false for new notes and true for deleted notes.	boolean	"archived": false
mentionedUserIds	id	Hi Marley internally generated id of the mentioned user	array	"mentionedUserIds": [ "5bfa662f-2026-4bfa-be39-57a8ae7b083f" ]
authorId	id	Hi Marley internally generated id of the author	string	"authorId": "643bb2f8-f82d-4e71-94f0-fad78172024a"
plainText		The body of the newly created note.	string	"plainText": "Hello @ExampleUser"
replies		This field will list your response to the original note.	string	"replies": [ { "archived": false, "mentionedUserIds": [ "643bb2f8-f82d-4e71-94f0-fad78172024a" ], "authorId": "5bea662f-2026-4bfa-be39-57a9ae6b083f", "plainText": "Hello @ExampleUser how are you?", "id": "556e14ac-25e7-489a-8458-1faf452d4d0b" } ]
id	id	The note id. Can be used for other case note API endpoints.	string	"id": "05b620d7-d4f6-46fa-b1d0-ede778b0fd99"

Reply to Note