Update a feature flag

PUT

https://app.unleash-instance.example.com/api/admin/projects/:projectId/features/:featureName

PUT

/api/admin/projects/:projectId/features/:featureName

curl -X PUT https://app.unleash-instance.example.com/api/admin/projects/projectId/features/featureName \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "name": "disable-comments",
  "type": "kill-switch",
  "description": "Controls disabling of the comments section in case of an incident",
  "archived": true,
  "project": "dx-squad",
  "enabled": true,
  "stale": false,
  "favorite": true,
  "impressionData": false,
  "createdAt": "2023-01-28T15:21:39.975Z",
  "createdBy": {
    "id": 123,
    "name": "User",
    "imageUrl": "https://example.com/242x200.png"
  },
  "archivedAt": "2023-01-29T15:21:39.975Z",
  "environments": [
    {
      "name": "my-dev-env",
      "enabled": true,
      "featureName": "disable-comments",
      "environment": "development",
      "type": "development",
      "sortOrder": 3,
      "variantCount": 1.1,
      "strategies": [
        {
          "name": "flexibleRollout",
          "id": "6b5157cb-343a-41e7-bfa3-7b4ec3044840",
          "title": "Gradual Rollout 25-Prod",
          "disabled": false,
          "featureName": "myAwesomeFeature",
          "sortOrder": 9999,
          "segments": [
            1,
            2
          ],
          "constraints": [
            {
              "contextName": "appName",
              "operator": "IN",
              "caseInsensitive": false,
              "inverted": false,
              "values": [
                "my-app",
                "my-other-app"
              ],
              "value": "my-app"
            }
          ],
          "variants": [
            {
              "name": "blue_group",
              "weight": 1,
              "weightType": "fix",
              "stickiness": "custom.context.field",
              "payload": {
                "type": "json",
                "value": "{\"color\": \"red\"}"
              }
            }
          ],
          "parameters": {}
        }
      ],
      "variants": [
        {
          "name": "blue_group",
          "weight": 1.1,
          "weightType": "variable",
          "stickiness": "custom.context.field",
          "payload": {
            "type": "json",
            "value": "{\"color\": \"red\"}"
          },
          "overrides": [
            {
              "contextName": "userId",
              "values": [
                "red",
                "blue"
              ]
            }
          ]
        }
      ],
      "changeRequestIds": [
        1.1
      ],
      "milestoneName": "Phase One",
      "milestoneOrder": 0,
      "totalMilestones": 0,
      "lastSeenAt": "2023-01-28T16:21:39.975Z",
      "hasStrategies": true,
      "hasEnabledStrategies": true,
      "releasePlans": [
        {
          "id": "01JB9GGTGQYEQ9D40R17T3YVW2",
          "discriminator": "plan",
          "name": "My release plan",
          "featureName": "my-feature",
          "environment": "production",
          "createdByUserId": 53,
          "createdAt": "2022-01-01T00:00:00Z",
          "milestones": [
            {
              "id": "01JB9GGTGQYEQ9D40R17T3YVW1",
              "name": "My milestone",
              "sortOrder": 1,
              "releasePlanDefinitionId": "01JB9GGTGQYEQ9D40R17T3YVW2",
              "startedAt": "2024-01-01T00:00:00.000Z",
              "transitionCondition": {},
              "progressionExecutedAt": "2024-01-01T00:00:00.000Z",
              "pausedAt": "2024-01-01T00:00:00.000Z",
              "strategies": [
                {
                  "id": "01JB9GGTGQYEQ9D40R17T3YVW3",
                  "milestoneId": "01JB9GGTGQYEQ9D40R17T3YVW1",
                  "sortOrder": 9999,
                  "name": "flexibleRollout",
                  "strategyName": "flexibleRollout",
                  "title": "Gradual Rollout 25-Prod",
                  "parameters": {
                    "groupId": "some_new",
                    "rollout": "25",
                    "stickiness": "sessionId"
                  },
                  "constraints": [
                    {
                      "contextName": "appName",
                      "operator": "IN",
                      "caseInsensitive": false,
                      "inverted": false,
                      "values": [
                        "1",
                        "2"
                      ]
                    }
                  ],
                  "variants": [
                    {
                      "name": "blue_group",
                      "weight": 1,
                      "weightType": "fix",
                      "stickiness": "custom.context.field",
                      "payload": {
                        "type": "json",
                        "value": "{\"color\": \"red\"}"
                      }
                    }
                  ],
                  "segments": [
                    1,
                    2
                  ],
                  "disabled": false
                }
              ]
            }
          ],
          "releasePlanTemplateId": "01JB9GGTGQYEQ9D40R17T3YVW2",
          "description": "This is my release plan",
          "activeMilestoneId": "01JB9GGTGQYEQ9D40R17T3YVW1",
          "safeguards": [
            {
              "id": "01JB9GGTGQYEQ9D40R17T3YVW1",
              "action": {
                "type": "pauseReleasePlanProgressions",
                "id": "01JB9GGTGQYEQ9D40R17T3YVW2"
              },
              "triggerCondition": {
                "operator": ">",
                "threshold": 100
              },
              "impactMetric": {
                "id": "01JB9GGTGQYEQ9D40R17T3YVW1",
                "metricName": "unleash_counter_feature_toggle_usage_total",
                "timeRange": "day",
                "aggregationMode": "rps",
                "labelSelectors": {
                  "environment": [
                    "development"
                  ],
                  "project": [
                    "default"
                  ]
                },
                "source": "internal"
              }
            }
          ]
        }
      ],
      "safeguards": [
        {
          "id": "01JB9GGTGQYEQ9D40R17T3YVW1",
          "action": {
            "type": "disableFeatureEnvironment",
            "featureName": "string",
            "environment": "string",
            "project": "string"
          },
          "triggerCondition": {
            "operator": ">",
            "threshold": 100
          },
          "impactMetric": {
            "id": "01JB9GGTGQYEQ9D40R17T3YVW1",
            "metricName": "unleash_counter_feature_toggle_usage_total",
            "timeRange": "day",
            "aggregationMode": "rps",
            "labelSelectors": {
              "environment": [
                "development"
              ],
              "project": [
                "default"
              ]
            },
            "source": "internal"
          }
        }
      ],
      "yes": 974,
      "no": 50
    }
  ],
  "tags": [
    {
      "value": "a-tag-value",
      "type": "simple",
      "color": "#FFFFFF"
    }
  ],
  "children": [
    "some-feature"
  ],
  "lifecycle": {
    "stage": "initial",
    "enteredStageAt": "2023-01-28T15:21:39.975Z",
    "status": "kept"
  },
  "dependencies": [
    {
      "feature": "some-feature",
      "enabled": true,
      "variants": [
        "some-feature-blue-variant"
      ]
    }
  ],
  "collaborators": {
    "users": [
      {
        "id": 123,
        "name": "User",
        "imageUrl": "https://example.com/242x200.png"
      }
    ]
  },
  "links": [
    {
      "id": "01JTJNCJ5XVP2KPJFA03YRBZCA",
      "url": "https://github.com/search?q=cleanupReminder&type=code",
      "title": "Github cleanup",
      "feature": "disable-comments"
    }
  ]
}

Updates the specified feature if the feature belongs to the specified project. Only the provided properties are updated; any feature properties left out of the request body are left untouched.

Authentication

Authorizationstring

API key needed to access this API

AuthorizationBearer

API key needed to access this API, in Bearer token format

Path parameters

projectIdstringRequired

featureNamestringRequired

Request

updateFeatureSchema

descriptionstringOptional

Detailed description of the feature

typeenumOptional

Type of the flag e.g. experiment, kill-switch, release, operational, permission, sunset

stalebooleanOptional

true if the feature is archived

archivedbooleanOptional

If true the feature flag will be moved to the archive with a property archivedAt set to current time

impressionDatabooleanOptional

true if the impression data collection is enabled for the feature

Response

featureSchema

namestring

Unique feature name

typestringOptional

Type of the flag e.g. experiment, kill-switch, release, operational, permission

descriptionstring or nullOptional

Detailed description of the feature

archivedbooleanOptional

true if the feature is archived

projectstringOptional

Name of the project the feature belongs to

enabledbooleanOptional

true if the feature is enabled, otherwise false.

stalebooleanOptional

true if the feature is stale based on the age and feature type, otherwise false.

favoritebooleanOptional

true if the feature was favorited, otherwise false.

impressionDatabooleanOptional

true if the impression data collection is enabled for the feature, otherwise false.

createdAtstring or nullOptionalformat: "date-time"

The date the feature was created

createdByobjectOptional

User who created the feature flag

archivedAtstring or nullOptionalformat: "date-time"

The date the feature was archived

environmentslist of objectsOptional

The list of environments where the feature can be used

tagslist of objects or nullOptional

The list of feature tags

childrenlist of stringsOptional

The list of child feature names. This is an experimental field and may change.

lifecycleobjectOptional

Current lifecycle stage of the feature

dependencieslist of objectsOptional

The list of parent dependencies. This is an experimental field and may change.

collaboratorsobjectOptional

Information related to users who have made changes to this feature flage.

linkslist of objectsOptional

The list of links. This is an experimental field and may change.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

415

Unsupported Media Type Error