---
title: "Modifies a feature toggle"
method: PUT
path: "/spaces/{spaceIdentifier}/projects/{projectId}/featuretoggles/{id}"
tags: ["FeatureToggles"]
---

# Modifies a feature toggle

`PUT /spaces/{spaceIdentifier}/projects/{projectId}/featuretoggles/{id}`

## Path parameters

- `spaceIdentifier` string, required
- `projectId` string, required
- `id` string, required

## Request body

- ModifyFeatureToggleCommand
  - `DefaultIsEnabled` boolean
  - `Description` string
  - `Environments` ModifyFeatureToggleEnvironment[], required — The complete set of per-environment configurations for the toggle. This replaces the existing set: environments omitted here are removed from the toggle.
    - `ClientRolloutPercentage` integer
    - `DeploymentEnvironmentId` string, required
    - `ExcludedTenantIds` string[]
    - `ExcludedTenantTags` string[]
    - `IsEnabled` boolean, required
    - `MinimumVersion` string — A semantic version, for example '2.1.0'. When set, the toggle is only enabled for clients whose application version, reported through the feature toggle SDK, is at or above this version.
    - `RolloutPercentage` integer
    - `Segments` StringStringKeyValuePair[] — Key/value targeting rules matched against the evaluation context supplied by the client application through the feature toggle SDK, for example {"key": "region", "value": "us-east"}. When set, the toggle is only enabled for clients whose context matches.
      - `Key` string
      - `Value` string
    - `TenantIds` string[]
    - `TenantTags` string[]
  - `Id` string, required
  - `Name` string, required
  - `ProjectId` string, required
  - `RolloutGroupId` string
  - `Slug` string, required
  - `SpaceId` string, required
  - `Tags` string[]

## Response `200`

A feature toggle

- FeatureToggleResource
  - `DefaultIsEnabled` boolean, required
  - `Description` string
  - `Environments` FeatureToggleEnvironmentResource[], required
    - `ClientRolloutPercentage` integer
    - `DeploymentEnvironmentId` string, required
    - `ExcludedTenantIds` string[]
    - `ExcludedTenantTags` string[]
    - `FeatureToggleId` string, required
    - `IsEnabled` boolean, required
    - `MinimumVersion` string
    - `RolloutPercentage` integer
    - `Segments` StringStringKeyValuePair[]
      - `Key` string
      - `Value` string
    - `TenantIds` string[]
    - `TenantTags` string[]
  - `Id` string, required
  - `Name` string, required
  - `ProjectId` string, required
  - `RolloutGroupId` string
  - `Slug` string, required
  - `SpaceId` string, required
  - `Tags` string[], required

## Other responses

- `400` — Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404` — Not found. One or more of the entities involved in the operation was not found.

---

[API](https://skmtc.net/octopus/apis/octopus-server-api.md) · [All operations](https://skmtc.net/octopus/apis/octopus-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/octopus/octopus-server-api/versions/bc9158facfc7/schema)