fix(specs): Add customSearchParameters to Variant schema, and add direction query param for GET abtests (#5130)

Co-authored-by: Clément Vannicatte <[email protected]>

Author: leonardogavaudan

specs/abtesting-v3/common/parameters.yml

@@ -156,3 +156,14 @@ createMetric:
     - name: conversionRate
     - name: clickThroughRate
     - name: trackedSearchCount
+
+direction:
+  type: string
+  description: |
+    Sort order for A/B tests by start date.
+    Use 'asc' for ascending or 'desc' for descending.
+    Active A/B tests are always listed first.
+  enum:
+    - asc
+    - desc
+  example: desc

specs/abtesting-v3/common/schemas/Variant.yml

@@ -29,6 +29,12 @@ variant:
       $ref: '#/metrics'
     metadata:
       $ref: '#/variantMetadata'
+    customSearchParameters:
+      type: object
+      description: |
+        Search parameters applied to this variant when the same index is used for multiple variants.
+        Only present if custom search parameters were provided during test creation.
+      example: {'enablePersonalization': true, 'personalizationImpact': 50}
 
   required:
     - index

specs/abtesting-v3/paths/abtests.yml

@@ -96,6 +96,14 @@ get:
       example: '_development'
       schema:
         type: string
+    - name: direction
+      in: query
+      description: |
+        Sort order for A/B tests by start date.
+        Use 'asc' for ascending or 'desc' for descending. Active A/B tests are always listed first.
+      example: desc
+      schema:
+        $ref: '../common/parameters.yml#/direction'
   responses:
     '200':
       description: OK