doc(abtests) add timeseries endpoint for v3 + add confidence interval values in variant schema

Author: Niamsy

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

@@ -0,0 +1,43 @@
+Timeseries:
+  type: object
+  additionalProperties: false
+  properties:
+    abTestID:
+      $ref: "../parameters.yml#/abTestID"
+    variants:
+      $ref: "#/timeseriesVariants"
+  required:
+    - abTestID
+    - variants
+
+timeseriesVariants:
+  type: array
+  description: |
+    A/B test timeseries variants.
+
+    The first variant is your _control_ index, typically your production index.
+    All of the additional variants are indexes with changed settings that you want to test against the control.
+  items:
+    $ref: "#/timeseriesVariant"
+
+timeseriesVariant:
+  type: object
+  properties:
+    dates:
+      $ref: "#/metricDates"
+
+metricDates:
+  type: array
+  items:
+    $ref: "#/metricDate"
+
+metricDate:
+  type: object
+  properties:
+    date:
+      type: string
+      description: Date where the metric was updated, in RFC 3339 format.
+      format: date
+      example: 2025-06-15
+    metrics:
+       $ref: "Variant.yml#/metrics"

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

@@ -53,10 +53,22 @@ metric:
     value:
       type: number
       format: double
+    valueCIHigh:
+      type: number
+      format: double
+    valueCILow:
+      type: number
+      format: double
     pValue:
       type: number
       format: double
       description: PValue for the first variant (control) will always be 0. For the other variants, pValue is calculated for the current variant based on the control.
+    pValueCIHigh:
+      type: number
+      format: double
+    pValueCILow:
+      type: number
+      format: double
     dimension:
       type: string
       description: Dimension defined during test creation

specs/abtesting-v3/paths/timeseries.yml

@@ -0,0 +1,32 @@
+get:
+  tags:
+    - abtest
+  operationId: getTimeseries
+  x-acl:
+    - analytics
+  summary: Retrieve timeseries of an A/B test
+  description: Retrieves timeseries for an A/B test by its ID.
+  parameters:
+    - $ref: '../common/parameters.yml#/ID'
+  responses:
+    '200':
+      description: OK
+      headers:
+        x-ratelimit-limit:
+          $ref: '../../common/responses/rateLimit.yml#/x-ratelimit-limit'
+        x-ratelimit-remaining:
+          $ref: '../../common/responses/rateLimit.yml#/x-ratelimit-remaining'
+        x-ratelimit-reset:
+          $ref: '../../common/responses/rateLimit.yml#/x-ratelimit-reset'
+      content:
+        application/json:
+          schema:
+            $ref: '../common/schemas/Timeseries.yml#/Timeseries'
+    '400':
+      $ref: '../../common/responses/BadRequest.yml'
+    '402':
+      $ref: '../../common/responses/FeatureNotEnabled.yml'
+    '403':
+      $ref: '../../common/responses/MethodNotAllowed.yml'
+    '404':
+      $ref: '../../common/responses/IndexNotFound.yml'

specs/abtesting-v3/spec.yml

@@ -101,6 +101,8 @@ paths:
     $ref: "paths/scheduleABTest.yml"
   /3/abtests/estimate:
     $ref: "paths/estimate.yml"
+  /3/abtests/{id}/timeseries:
+    $ref: "paths/timeseries.yml"
 
   # ###############
   # ### Helpers ###