From 6de4b2f42e5079264302979d6233d97f496eba65 Mon Sep 17 00:00:00 2001
From: Gagan Trivedi <gagandeeptrivedi47@gmail.com>
Date: Fri, 5 Jun 2026 13:50:33 +0530
Subject: [PATCH] feat(sdk): add variant to the /identities response flag
 schema

Propose an optional, nullable `variant` on each flag in the
/api/v1/identities/ response: a stable identifier of the multivariate
variant selected for the identity, named after OpenFeature's
ResolutionDetails.variant. Schema-only change to gather feedback on the
remote evaluation contract; no behaviour change.
---
 sdk/openapi.yaml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/sdk/openapi.yaml b/sdk/openapi.yaml
index 2422d7dc3133..8604aa58c346 100644
--- a/sdk/openapi.yaml
+++ b/sdk/openapi.yaml
@@ -539,6 +539,15 @@ components:
             - type: string
             - type: 'null'
           title: Feature State Value
+        variant:
+          description: >-
+            A stable identifier of the multivariate variant selected for this
+            identity. `null` when no variant was selected, or when the selected
+            variant has no key set.
+          anyOf:
+            - type: string
+            - type: 'null'
+          title: Variant
       required:
         - feature
         - enabled