---
title: "Update predefined variations"
method: PUT
path: "/v1/settings/{settingId}/predefined-variations"
tags: ["Feature Flags & Settings"]
---

# Update predefined variations

`PUT /v1/settings/{settingId}/predefined-variations`

This endpoint updates the predefined variations for a Feature Flag or Setting identified by the `settingId` parameter.

**Important:** You can only update a predefined variation's value if it is not used anywhere in your feature flags.

## Path parameters

- `settingId` integer, required

## Request body

- UpdatePredefinedVariationsRequest
  - `predefinedVariations` UpdatePredefinedVariationModel[], required — A collection of Predefined Variations.
    - `value` UpdatePredefinedVariationValueModel, required — Represents the value of a Predefined Variation.
      - `boolValue` boolean, nullable — The served value in case of a boolean Feature Flag.
      - `stringValue` string, nullable — The served value in case of a text Setting.
      - `intValue` integer, nullable — The served value in case of a whole number Setting.
      - `doubleValue` number, double, nullable — The served value in case of a decimal number Setting.
    - `name` string, nullable — The name of the Predefined Variation, shown on the Dashboard UI. If not set, the Value will be shown.
    - `hint` string, nullable — The name of the Predefined Variation, shown on the Dashboard UI. If not set, the Value will be shown.
    - `predefinedVariationId` string, uuid, nullable — The Predefined Variation's identifier to update. Omit the value if you want to add a new predefined variation.

## Response `200`

When the update was successful.

- PredefinedVariationsModel
  - `predefinedVariations` PredefinedVariationModel[], required — The Feature Flag or Setting's Variations.
    - `value` PredefinedVariationValueModel, required — Represents the value of a Predefined Variation.
      - `boolValue` boolean, nullable, required — The served value in case of a boolean Feature Flag.
      - `stringValue` string, nullable, required — The served value in case of a text Setting.
      - `intValue` integer, nullable, required — The served value in case of a whole number Setting.
      - `doubleValue` number, double, nullable, required — The served value in case of a decimal number Setting.
    - `name` string, nullable, required — The name of the Predefined Variation, shown on the Dashboard UI. If not set, the Value will be shown.
    - `hint` string, nullable, required — The name of the Predefined Variation, shown on the Dashboard UI. If not set, the Value will be shown.
    - `predefinedVariationId` string, uuid, required — The Predefined Variation's identifier.
  - `maxPredefinedVariations` integer, required — The maximum number of predefined variations allowed for the Feature Flag or Setting.

## Other responses

- `400` — Bad request.
- `404` — Not found.
- `429` — Too many requests. In case of the request rate exceeds the rate limits.

---

[API](https://skmtc.net/configcat/apis/configcat-public-management-api.md) · [All operations](https://skmtc.net/configcat/apis/configcat-public-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/configcat/configcat-public-management-api/versions/6b4d53bc1455/schema)