POST Search a Conversation

URL: http://{server-url}/api/v1/request/104/conversation/search/byqual

You can search a conversation within a Request or Service Request by calling the above endpoint with the ticket ID.

You need the following key-values:

Header

Key	Description
Authorization	Bearer/API Key {access token obtained after authorization}

Body

{
    "qualDetails": {
        "type": "FlatQualificationRest",
        "quals": [
            {
                "type": "RelationalQualificationRest",
                "leftOperand": {
                    "type": "PropertyOperandRest",
                    "key": ".conversation.conversationType"
                },
                "operator": "equal",
                "rightOperand": {
                    "type": "ValueOperandRest",
                    "value": {
                        "type": "EnumValueRest",
                        "value": "note/collaborate/requestor_to_technician"
                    }
                }
            }
        ]
    }
}

note

To upload an attachment along with converation, first upload the attachment using the Upload Attachment API and then use its response in the body of this API.

Example (Request & Response)

Request

curl --location 'http://172.16.11.160/api//v1/request/104/conversation/search/byqual' \
--header 'Authorization: Apikey cnvwSGGPRGPVXApR%40RxLdhBMktQ4RLjxhf36qzfwql3i3Ao7zPDaJKLF1Ty5ZT3aFi0Z%2B' \
--header 'Content-Type: application/json' \
--data '{
    "qualDetails": {
        "type": "FlatQualificationRest",
        "quals": [
            {
                "type": "RelationalQualificationRest",
                "leftOperand": {
                    "type": "PropertyOperandRest",
                    "key": ".conversation.conversationType"
                },
                "operator": "equal",
                "rightOperand": {
                    "type": "ValueOperandRest",
                    "value": {
                        "type": "EnumValueRest",
                        "value": "note"
                    }
                }
            }
        ]
    }
}

Response

{
    "objectList": [
        {
            "id": 2,
            "conversationType": "note",
            "details": "<p>Please take this request on priority.</p>",
            "createdByName": "Adam",
            "createdByEmail": "adam@motadata.com",
            "createdTime": "Wed, Jul 16, 2025 04:33 pm",
            "updatedTime": "Wed, Jul 16, 2025 06:30 pm",
            "subject": "[INC-104]: Email Server is Down",
            "conversationState": "published",
            "emailIds": [],
            "ccEmailIds": [],
            "updatable": true,
            "deletable": true,
            "fileAttachments": []
        }
    ],
    "totalCount": 1
}