Class FeatureFlagsApi

Archives a feature flag. Archived flags are hidden from the main list but remain accessible and can be unarchived.

Creates a new targeting rule (allocation) for a specific feature flag in a specific environment.

Creates a new feature flag with variants.

Creates a new environment for organizing feature flags.

Adds a single new variant to an existing feature flag. This endpoint is additive-only: it never modifies existing variants. A request whose key already exists on the flag is rejected with 409 Conflict; a value whose type does not match the flag's value_type is rejected with 400. The server generates the variant UUID and returns it in the response body; callers (for example, the flag-migration tool) need this UUID to reference the new variant in subsequent allocation syncs.

Deletes an environment. This operation cannot be undone.

Deletes a variant from a feature flag.

When backend approvals are enabled and the flag requires approval, this endpoint creates and returns a FlagSuggestion with 201 Created instead of deleting the variant immediately. If a pending suggestion already exists for this flag's variant property, the endpoint returns 409 Conflict.

Disable a feature flag in a specific environment.

Enable a feature flag in a specific environment.

Returns the details of a specific feature flag including variants and environment status.

Returns the details of a specific environment.

Returns a list of feature flags for the organization. Supports filtering by key and archived status.

Returns a list of environments for the organization. Supports filtering by name and key.

Pauses a progressive rollout while preserving rollout state.

Resumes progression for a previously paused progressive rollout.

Starts a progressive rollout and begins progression.

Stops a progressive rollout and marks it as aborted.

Unarchives a previously archived feature flag, making it visible in the main list again.

Updates targeting rules (allocations) for a specific feature flag in a specific environment. This operation replaces the existing allocation set with the request payload.

Updates an existing feature flag's metadata such as name and description. Does not modify targeting rules or allocations.

Updates an existing environment's metadata such as name and description.

Updates the name and value of an existing variant on a feature flag.

When backend approvals are enabled and the flag requires approval, this endpoint creates and returns a FlagSuggestion with 201 Created instead of applying the change immediately. Use the returned suggestion id to approve or reject the change. If a pending suggestion already exists for this flag's variant property, the endpoint returns 409 Conflict.