feat(api): add experimental feature flag update endpoints #6305

gagantrivedi · 2025-11-19T14:04:54Z

Thanks for submitting a PR! Please check the boxes below:

I have added information to docs/ if required so people know about the feature!
I have filled in the "Changes" section below?
I have filled in the "How did you test this code" section below?
I have used a Conventional Commit title for this Pull Request

Changes

Adds two new experimental endpoints under /api/experiments/:

update-flag-v1: Update single feature state (environment default or segment override)
update-flag-v2: Update multiple feature states in a single request (environment default + segment overrides)
Related issues: Create new experimental endpoint to update a single feature state for a given feature #6279 Create new experimental endpoints to update a given feature in an environment #6233

How did you test this code?

Unit tests

Adds two new experimental endpoints under /api/experiments/: - update-flag-v1: Update single feature state (environment default or segment override) - update-flag-v2: Update multiple feature states in a single request (environment default + segment overrides)

vercel · 2025-11-19T14:04:59Z

The latest updates on your projects. Learn more about Vercel for GitHub.

3 Skipped Deployments

Project	Deployment	Preview	Updated (UTC)
docs	Ignored	Preview	Dec 4, 2025 0:06am
flagsmith-frontend-preview	Ignored	Preview	Dec 4, 2025 0:06am
flagsmith-frontend-staging	Ignored	Preview	Dec 4, 2025 0:06am

for more information, see https://pre-commit.ci

codecov · 2025-11-26T11:23:12Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.05%. Comparing base (bebb47b) to head (b8eeb6d).
⚠️ Report is 28 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #6305      +/-   ##
==========================================
+ Coverage   98.02%   98.05%   +0.03%     
==========================================
  Files        1280     1289       +9     
  Lines       45406    46141     +735     
==========================================
+ Hits        44508    45243     +735     
  Misses        898      898

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

- Parameterize test_update_flag_by_name for all value types (integer, string, boolean) - Remove unsupported float type from serializer (model doesn't support it) - Add test_serializers.py with unit tests for edge cases - Add test for duplicate segment_id validation - Add tests for updating existing segment overrides with priority - Add unit tests for boolean string conversion and replica path - Refactor _update_flag_for_versioning_v2 to separate segment vs environment default cases for cleaner code and full coverage

Replace SDK endpoint calls with direct database verification using get_environment_flags_list. This keeps the tests as proper unit tests rather than integration tests. - Remove sdk_client and sdk_client_factory fixtures - Remove get_identity_feature_state_from_sdk helper function - Remove Identity, Condition, SegmentRule imports and usage - Simplify segment override tests to verify database state directly

cursor

This is the final PR Bugbot will review for you during this billing cycle

Your free Bugbot reviews will reset on December 10

Details

Your team is on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle for each member of your team.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

api/features/versioning/versioning_service.py

…ning The previous filter Q(feature_segment__segment_id=None) relies on LEFT OUTER JOIN behavior to match NULL FKs. Using Q(feature_segment__isnull=True) is more explicit and robust as it directly checks the FK column.

api/features/versioning/versioning_service.py

The _update_feature_state_value function was setting new typed values without clearing old value fields when changing types. This left stale data in the database. Added set_value() method to AbstractBaseFeatureValueModel that centralizes validation, type conversion, and ensures unused fields are cleared.

The filter Q(feature_segment__isnull=True) doesn't exclude identity overrides, which also have feature_segment=None. Added identity_id__isnull=True to correctly retrieve only the environment default state.

api/features/versioning/versioning_service.py

…rides Creating a FeatureSegment with a priority value doesn't trigger reordering of existing segments. Use .to() after creation to properly reorder. Fixes both V1 and V2 endpoints.

api/features/feature_states/serializers.py

…helper

…ride Prevents cross-project segment references and provides clear error messages for non-existent segments.

emyller

The experiment looks solid, despite the complexity brought by the 2x2 grid experiment x versioning version. Few suggestions.

emyller · 2025-12-04T21:01:51Z

api/environments/identities/models.py


    def update_traits(
        self,
+        # TODO: this typing isn't true as it also supports regular dicts like {"trait_key": "foo", "trait_value": "bar"}


Can we have an issue to cover this?

emyller · 2025-12-04T21:06:29Z

api/features/feature_states/serializers.py

+    @property
+    def environment(self) -> Environment:
+        environment: Environment | None = self.context.get("environment")
+        if not environment:
+            raise serializers.ValidationError("Environment context is required")
+        return environment


I feel like this could be a mixin to reuse in many other views, though I appreciate it's out of scope.

emyller · 2025-12-04T21:09:53Z

api/features/feature_states/serializers.py

+        if value_type == "integer":
+            try:
+                int(string_val)
+            except ValueError:
+                raise serializers.ValidationError(
+                    f"'{string_val}' is not a valid integer"
+                )
+        elif value_type == "boolean":
+            if string_val.lower() not in ("true", "false"):
+                raise serializers.ValidationError(
+                    f"'{string_val}' is not a valid boolean (use 'true' or 'false')"
+                )


Can we have this logic abstracted? It is repeated but raising distinct exceptions, e.g. ValueError there, and ValidationError here.

emyller · 2025-12-04T22:48:19Z

api/tests/unit/features/feature_states/test_serializers.py

+    )
+    serializer.is_valid()
+
+    with pytest.raises(Exception) as exc_info:


Is it possible to narrow down this exception type?

emyller · 2025-12-04T22:49:14Z

api/tests/unit/features/feature_states/test_serializers.py

Missing Given/When/Then markers.

emyller · 2025-12-05T00:04:04Z

api/features/versioning/versioning_service.py

    )


+def update_flag(


These functions perform multiple database writes without @transaction.atomic. Can we wrap them?

emyller · 2025-12-05T00:05:49Z

api/features/versioning/versioning_service.py

+
+    updated_segments = []
+    for override in change_set.segment_overrides:
+        segment_states = get_environment_flags_dict(


get_environment_flags_dict is called once per segment override. Can we batch this into a single query?

emyller · 2025-12-05T00:06:56Z

api/features/versioning/versioning_service.py

+        feature_name=feature.name,
+        additional_filters=Q(feature_segment__isnull=True, identity_id__isnull=True),
+    )
+    assert len(env_default_states) == 1


assert provides no message when it fails. Can we raise an explicit exception instead?

emyller · 2025-12-05T00:08:26Z

api/tests/unit/features/feature_states/test_unit_feature_states_views.py

Can we have a test for concurrent modifications? This is relevant since atomicity is not implemented yet (see other thread).

matthewelwell and others added 2 commits October 29, 2025 10:23

Initial PoC for new endpoint

4ea79aa

gagantrivedi changed the title ~~Feat/experimental flag update endpoints~~ feat(api): add experimental feature flag update endpoints Nov 19, 2025

github-actions bot added the api Issue related to the REST API label Nov 19, 2025

gagantrivedi and others added 2 commits November 19, 2025 19:42

Merge branch 'main' into feat/experimental-flag-update-endpoints

0bc2de2

[pre-commit.ci] auto fixes from pre-commit.com hooks

d128862

for more information, see https://pre-commit.ci

github-actions bot added the feature New feature or request label Nov 19, 2025

Typing fixes

4e6cec8

github-actions bot added feature New feature or request and removed feature New feature or request labels Nov 26, 2025

Update SegmentSerializer name

b0c0a6a

github-actions bot added feature New feature or request and removed feature New feature or request labels Nov 26, 2025

github-actions bot added feature New feature or request and removed feature New feature or request labels Nov 28, 2025

misc

bf7bd7b

github-actions bot added feature New feature or request and removed feature New feature or request labels Nov 28, 2025

return 403 if change request is enabled

db2477e

github-actions bot added feature New feature or request and removed feature New feature or request labels Nov 28, 2025

gagantrivedi force-pushed the feat/experimental-flag-update-endpoints branch from f280c7f to b987697 Compare November 28, 2025 13:29

cursor bot reviewed Dec 3, 2025

View reviewed changes

api/features/versioning/versioning_service.py Show resolved Hide resolved

github-actions bot added feature New feature or request and removed feature New feature or request labels Dec 3, 2025

cursor bot reviewed Dec 3, 2025

View reviewed changes

api/features/versioning/versioning_service.py Show resolved Hide resolved

github-actions bot added feature New feature or request and removed feature New feature or request labels Dec 4, 2025

cursor bot reviewed Dec 4, 2025

View reviewed changes

api/features/versioning/versioning_service.py Outdated Show resolved Hide resolved

api/features/versioning/versioning_service.py Outdated Show resolved Hide resolved

gagantrivedi added 2 commits December 4, 2025 13:02

fix: add identity filter to V1 versioning environment default queries

39c4b44

The filter Q(feature_segment__isnull=True) doesn't exclude identity overrides, which also have feature_segment=None. Added identity_id__isnull=True to correctly retrieve only the environment default state.

gagantrivedi force-pushed the feat/experimental-flag-update-endpoints branch from 6fb8e9b to e998a78 Compare December 4, 2025 08:02

github-actions bot added feature New feature or request and removed feature New feature or request labels Dec 4, 2025

cursor bot reviewed Dec 4, 2025

View reviewed changes

api/features/versioning/versioning_service.py Show resolved Hide resolved

gagantrivedi force-pushed the feat/experimental-flag-update-endpoints branch from e998a78 to 56443a0 Compare December 4, 2025 08:21

github-actions bot added feature New feature or request and removed feature New feature or request labels Dec 4, 2025

cursor bot reviewed Dec 4, 2025

View reviewed changes

api/features/versioning/versioning_service.py Show resolved Hide resolved

fix: use .to() for priority reordering when creating new segment over…

8d43e11

…rides Creating a FeatureSegment with a priority value doesn't trigger reordering of existing segments. Use .to() after creation to properly reorder. Fixes both V1 and V2 endpoints.

gagantrivedi force-pushed the feat/experimental-flag-update-endpoints branch from 56443a0 to 8d43e11 Compare December 4, 2025 11:31

github-actions bot added feature New feature or request and removed feature New feature or request labels Dec 4, 2025

cursor bot reviewed Dec 4, 2025

View reviewed changes

api/features/feature_states/serializers.py Show resolved Hide resolved

gagantrivedi added 2 commits December 4, 2025 17:15

cleanup: refactor versioning service to remove early returns and use …

ce92682

…helper

fix: validate segment belongs to project before creating segment over…

b8eeb6d

…ride Prevents cross-project segment references and provides clear error messages for non-existent segments.

github-actions bot added feature New feature or request and removed feature New feature or request labels Dec 4, 2025

khvn26 assigned emyller and matthewelwell Dec 4, 2025

emyller requested changes Dec 5, 2025

View reviewed changes

feat(api): add experimental feature flag update endpoints #6305

Are you sure you want to change the base?

feat(api): add experimental feature flag update endpoints #6305

Uh oh!

Conversation

gagantrivedi commented Nov 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

How did you test this code?

Uh oh!

vercel bot commented Nov 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov bot commented Nov 26, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

This is the final PR Bugbot will review for you during this billing cycle

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

emyller left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

gagantrivedi commented Nov 19, 2025 •

edited

Loading

vercel bot commented Nov 19, 2025 •

edited

Loading

codecov bot commented Nov 26, 2025 •

edited

Loading