POST Search a Conversation

URL: http://{{server-url}}/api/v1/release/{release_id}/conversation/search/byqual

Example: http://172.16.11.160/api/v1/release/9/conversation/search/byqual

You can search a conversation (collaborate and note) within a release 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"
                    }
                }
            }
        ]
    }
}

note

To upload an attachment along with a conversation, 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/release/9/conversation/search/byqual' \
--header 'Authorization: Apikey UMKSU3dhE8ERESeb%40LiklySVfaJL2i42wh%2Behea9x%2FmW46Uu5YZUz6YnxFSyQ6w%3D%3D' \
--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": 156,
            "conversationType": "note",
            "details": "<p>This is an internal note about the request progress.</p>",
            "createdByName": "Jerry",
            "createdByEmail": "jerry@motadata.com",
            "createdTime": "Fri, May 29, 2026 05:41 pm",
            "updatedTime": "Fri, May 29, 2026 06:32 pm",
            "subject": "[REL-9]: New Software Release v8.7.4",
            "conversationState": "published",
            "emailIds": [],
            "ccEmailIds": [],
            "updatable": true,
            "deletable": true,
            "fileAttachments": []
        }
    ],
    "totalCount": 1
}