v1.16: Add sort parameter to /documents route (#3318)

Author: guimachiavelli

reference/api/documents.mdx

@@ -48,6 +48,8 @@ Use `offset` and `limit` to browse through documents.
 | **`fields`** | Array of strings/`null`                 | `*`           | Document attributes to show (case-sensitive, comma-separated)         |
 | **`filter`** | String/Array of array of strings/`null` | N/A           | Refine results based on attributes in the `filterableAttributes` list |
 | **`retrieveVectors`**    | Boolean                     | `false`       | Return document vector data with search result                        |
+| **`sort`**    | `null`  | A list of attributes written as an array or as a comma-separated string                     |
+
 | **`ids`**    | Array of primary keys                   | `null`        | Return documents based on their primary keys                        |
 
 <Note>
@@ -137,6 +139,7 @@ Using the query parameters `offset` and `limit`, you can browse through all your
 | **`fields`**    | `*`           | Document attributes to show (case-sensitive, comma-separated)         |
 | **`filter`**    | N/A           | Refine results based on attributes in the `filterableAttributes` list |
 | **`retrieveVectors`**    | `false`  | Return document vector data with search result                    |
+| **`sort`**    | `null`  | A list of comma-separated attributes                     |
 | **`ids`**       | `null`        | Return documents based on their primary keys                          |
 
 ### Response

reference/errors/error_codes.mdx

@@ -180,6 +180,14 @@ The [`limit`](/reference/api/documents#query-parameters) parameter is invalid. I
 
 The [`offset`](/reference/api/documents#query-parameters) parameter is invalid. It should be an integer.
 
+## `invalid_document_sort`
+
+This error occurs if:
+
+- The syntax for the [`sort`](/reference/api/documents#body) parameter is invalid
+- The attribute used for sorting is not defined in the [`sortableAttributes`](/reference/api/settings#sortable-attributes) list or the `sort` ranking rule is missing from the settings
+- A reserved keyword like `_geo`, `_geoDistance`, `_geoRadius`, or `_geoBoundingBox` is used as a filter
+
 ## `invalid_document_geo_field`
 
 The provided `_geo` field of one or more documents is invalid. Meilisearch expects `_geo` to be an object with two fields, `lat` and `lng`, each containing geographic coordinates expressed as a string or floating point number. Read more about `_geo` and how to troubleshoot it in [our dedicated guide](/learn/filtering_and_sorting/geosearch).