docs: added details about sort order in pagination (#3824)

packages/medusa/oas/admin.oas.base.yaml

@@ -222,6 +222,24 @@ info:
     
     For example, if the `count` is 100 and the `limit` is 50, you can divide the `count` by the `limit` to get the number of pages: `100/50 = 2 pages`.
 
+    ### Sort Order
+
+    The `order` field available on endpoints supporting pagination allows you to sort the retrieved items by an attribute of that item. For example, you can sort products by their `created_at` attribute by setting `order` to `created_at`:
+    
+    ```bash
+    curl "http://localhost:9000/admin/products?order=created_at" \
+    -H 'Authorization: Bearer {api_token}'
+    ```
+
+    By default, the sort direction will be ascending. To change it to descending, pass a dash (`-`) before the attribute name. For example:
+    
+    ```bash
+    curl "http://localhost:9000/admin/products?order=-created_at" \
+    -H 'Authorization: Bearer {api_token}'
+    ```
+    
+    This sorts the products by their `created_at` attribute in the descending order.
+
   license:
     name: MIT
     url: https://github.com/medusajs/medusa/blob/master/LICENSE

packages/medusa/oas/store.oas.base.yaml

@@ -205,6 +205,21 @@ info:
     
     For example, if the `count` is 100 and the `limit` is 50, you can divide the `count` by the `limit` to get the number of pages: `100/50 = 2 pages`.
 
+    ### Sort Order
+
+    The `order` field available on endpoints supporting pagination allows you to sort the retrieved items by an attribute of that item. For example, you can sort products by their `created_at` attribute by setting `order` to `created_at`:
+    
+    ```bash
+    curl "http://localhost:9000/list/products?order=created_at"
+    ```
+
+    By default, the sort direction will be ascending. To change it to descending, pass a dash (`-`) before the attribute name. For example:
+    
+    ```bash
+    curl "http://localhost:9000/list/products?order=-created_at"
+    ```
+    
+    This sorts the products by their `created_at` attribute in the descending order.
   license:
     name: MIT
     url: https://github.com/medusajs/medusa/blob/master/LICENSE

www/docs/src/css/_redocly.css

@@ -66,7 +66,7 @@
   color: var(--ifm-color-headers) !important;
 }
 
-.redocusaurus [data-section-id] > div:nth-child(2) h2, .redocusaurus [data-section-id] > div:nth-child(2) h3, .redocusaurus [data-section-id] > div:nth-child(2) h4 {
+.redocusaurus [data-section-id] [data-section-id] > div:nth-child(2) h2, .redocusaurus [data-section-id] [data-section-id] > div:nth-child(2) h3, .redocusaurus [data-section-id] [data-section-id] > div:nth-child(2) h4 {
   --ifm-color-headers: var(--medusa-text-on-color);
 }