---
title: "PUT /api/v1/environments/{environment_api_key}/featurestates/{id}/"
method: PUT
path: "/api/v1/environments/{environment_api_key}/featurestates/{id}/"
tags: ["mcp"]
---

# PUT /api/v1/environments/{environment_api_key}/featurestates/{id}/

`PUT /api/v1/environments/{environment_api_key}/featurestates/{id}/`

Updates a feature state in an environment, including enabled status and value. Applies to environments without v2 feature versioning (use_v2_feature_versioning: false).

## Path parameters

- `environment_api_key` string, required
- `id` integer, required

## Request body

- FeatureStateSerializerBasic — Adds nested create feature
  - `id` integer
  - `feature_state_value` union
    - string
    - integer
    - number
    - boolean
  - `multivariate_feature_state_values` MultivariateFeatureStateValue[]
    - `id` integer
    - `multivariate_feature_option` integer, required
    - `percentage_allocation` number, double, required
  - `identifier` string — Can be passed as an alternative to `identity`
  - `deleted_at` string, date-time, nullable
  - `uuid` string, uuid
  - `enabled` boolean
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `live_from` string, date-time, nullable
  - `version` integer, nullable
  - `feature` integer, required
  - `environment` integer, nullable
  - `identity` integer, nullable
  - `feature_segment` integer, nullable
  - `change_request` integer, nullable
  - `environment_feature_version` string, uuid, nullable

## Response `200`

- FeatureStateSerializerBasic — Adds nested create feature
  - `id` integer
  - `feature_state_value` union
    - string
    - integer
    - number
    - boolean
  - `multivariate_feature_state_values` MultivariateFeatureStateValue[]
    - `id` integer
    - `multivariate_feature_option` integer, required
    - `percentage_allocation` number, double, required
  - `identifier` string — Can be passed as an alternative to `identity`
  - `deleted_at` string, date-time, nullable
  - `uuid` string, uuid
  - `enabled` boolean
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `live_from` string, date-time, nullable
  - `version` integer, nullable
  - `feature` integer, required
  - `environment` integer, nullable
  - `identity` integer, nullable
  - `feature_segment` integer, nullable
  - `change_request` integer, nullable
  - `environment_feature_version` string, uuid, nullable

---

[API](https://skmtc.dev/flagsmith/apis/flagsmith-api.md) · [All operations](https://skmtc.dev/flagsmith/apis/flagsmith-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flagsmith/flagsmith-api/revisions/5a8154d05269/schema)