Search

Search conversations

Search for conversations containing a particular text.

SecurityApiKeyAuth
Request
query Parameters
exactMatch
boolean

Return only exact matches. This value is false by default.

pageKey
string

Base64 encoded form of pagination query parameters. Do not try to construct or change programmatically as the internal structure may change without notice.

pageLimit
integer <int32>

Maximum number of results per page. May be used in combination with pageKey to change the number of results in between page requests.

query
required
string non-empty

The text by which to search conversations

Example: query=cancel my order
Responses
200

The search results for the searched parameters

400

Invalid value extracted from request context, Invalid value for: query parameter pageLimit, Invalid value for: query parameter pageKey, Invalid value for: query parameter query, Invalid value for: query parameter exactMatch

401

The user who issued the access token used in the request is not authorized to perform the operation

500

Internal failure during request processing

get/v1/search/conversations
Request samples
Response samples
application/json
{
  • "data": [
    • {
      • "id": 1234,
      • "highlights": {
        • "subject": [
          • "<em class=\"highlight\">Cancel my order</em>"
          ]
        },
      • "innerHits": [
        • {
          • "id": "dadcaea0-4135-4e8a-a5bf-05d4658facba",
          • "highlight": {
            • "text": "I want to <em class=\"highlight\">cancel my order</em> as soon as possible"
            }
          }
        ],
      • "_type": "ConversationSearchHit"
      }
    ]
}