Add new endpoint /_api/key-generators

site/content/3.12/develop/http-api/collections.md

@@ -950,6 +950,45 @@ logJsonResponse(response);
 db._drop(cn);
 ```
 
+### Get the available key generators
+
+```openapi
+paths:
+  /_api/key-generators:
+    get:
+      operationId: getKeyGenerators
+      description: |
+        Returns the available key generators for collections.
+
+        The call returns a JSON object with the available key generators
+        on success:
+
+        - `padded`
+        - `uuid`
+        - `autoincrement`
+        - `traditional`
+      responses:
+        '200':
+          description: |
+            The key generators that were found.
+      tags:
+        - Collections
+```
+
+**Examples:**
+
+```curl
+---
+description: |-
+  Retrieving the key generators of collections:
+name: RestCollectionGetKeyGenerators
+---
+var url = "/_api/key-generators/"
+var response = logCurlRequest('GET', url);
+assert(response.code === 200);
+logJsonResponse(response);
+```
+
 ## Create and delete collections
 
 ### Create a collection

site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md

@@ -111,7 +111,15 @@ The default value remains 128 MiB.
 
 ### Endpoints added
 
+#### Collections API
 
+You can now retrieve the key generators for collections using the following
+endpoint:
+
+`GET /_api/key-generators`
+
+See the [description](../../develop/http-api/collections.md#get-the-available-key-generators)
+for details.
 
 ### Endpoints augmented