[Schema Inaccuracy] sort parameter is available but not documented.

[rassakhatsky]

Schema Inaccuracy

The searchConversations endpoint lacks documentation for the sort option, which is available but not mentioned. I'm trying to generate a Golang client.

Expected

I expect the documentation to include information about the sort functionality.

Reproduction Steps

Use the following cURL command with your Intercom API token:

curl -i -X POST \
  https://api.intercom.io/conversations/search \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Intercom-Version: 2.10' \
  -d '{
  "sort": {
    "field": "id",
    "order": "ascending"
  },
  "query": {
    // YOUR_QUERY_HERE
  }
}'

[jekh]

I believe this applies to other Search* operations too, such as SearchContacts.

I found the documentation for sort here: https://developers.intercom.com/docs/build-an-integration/learn-more/rest-apis/pagination-sorting-search/#sorting

But since it's not in the schema, it obviously makes consuming it in clients generated from the OpenAPI spec rather difficult.