From a918e5b32400fa2403aa565f463a52af3ff35c14 Mon Sep 17 00:00:00 2001
From: Ivan Kuchin <i.kuchin@openproject.com>
Date: Tue, 29 Oct 2024 19:10:47 +0100
Subject: [PATCH] describe versions sortBy parameter

---
 docs/api/apiv3/paths/versions.yml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/api/apiv3/paths/versions.yml b/docs/api/apiv3/paths/versions.yml
index 8c509fb6ab5f..e69e05a9acc6 100644
--- a/docs/api/apiv3/paths/versions.yml
+++ b/docs/api/apiv3/paths/versions.yml
@@ -14,6 +14,19 @@ get:
       required: false
       schema:
         type: string
+    - description: |-
+        JSON specifying sort criteria.
+        Accepts the same format as returned by the [queries](https://www.openproject.org/docs/api/endpoints/queries/) endpoint. Currently supported attributes are:
+
+        + id: Sort by the version id
+        + name: Sort by the version name using numeric collation, comparing sequences of decimal digits by their numeric value
+        + semver_name: Deprecated, use name instead
+      example: '[["name", "desc"]]'
+      in: query
+      name: sortBy
+      required: false
+      schema:
+        type: string
   responses:
     '200':
       content: