Sign in

v7

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-013764062.2 MB
Features

Update a milestone strategy

Enterprise feature

Update a milestone strategy configuration for a feature flag in the specified environment.

put/api/admin/projects/{project}/features/{featureName}/environments/{environment}/milestone-strategies/{strategyId}

Path parameters

projectstring required
featureNamestring required
environmentstring required
strategyIdstring required

Request body

sortOrdernumber

The order of the strategy in the list in feature environment configuration

titlestring nullable

A descriptive title for the strategy

disabledboolean nullable

A toggle to disable the strategy. defaults to true. Disabled strategies are not evaluated or returned to the SDKs

segmentsnumber[]

A list of segment ids attached to the strategy

parametersParametersSchema

A list of parameters for a strategy

Example request

{
  "constraints": [
    {
      "contextName": "appName",
      "operator": "IN",
      "values": [
        "my-app",
        "my-other-app"
      ],
      "value": "my-app"
    }
  ],
  "title": "Gradual Rollout 25-Prod",
  "variants": [
    {
      "name": "blue_group",
      "weightType": "fix",
      "stickiness": "custom.context.field",
      "payload": {
        "type": "json",
        "value": "{\"color\": \"red\"}"
      }
    }
  ],
  "segments": [
    1,
    2
  ]
}

Response

#/components/schemas/releasePlanMilestoneStrategySchema

idstring required

The milestone strategy's ID. Milestone strategy IDs are ulids.

milestoneIdstring required

The ID of the milestone that this strategy belongs to.

sortOrdernumber required

The order of the strategy in the list

titlestring nullable

A descriptive title for the strategy

namestring required

The name of the strategy type

strategyNamestring required

The name of the strategy type

parametersParametersSchema

A list of parameters for a strategy

segmentsnumber[]

Ids of segments to use for this strategy

disabledboolean nullable

A toggle to disable the strategy. defaults to false. Disabled strategies are not evaluated or returned to the SDKs

Example response

{
  "id": "01JB9GGTGQYEQ9D40R17T3YVW3",
  "milestoneId": "01JB9GGTGQYEQ9D40R17T3YVW1",
  "sortOrder": 9999,
  "title": "Gradual Rollout 25-Prod",
  "name": "flexibleRollout",
  "strategyName": "flexibleRollout",
  "constraints": [
    {
      "values": [
        "1",
        "2"
      ],
      "inverted": false,
      "operator": "IN",
      "contextName": "appName",
      "caseInsensitive": false
    }
  ],
  "variants": [
    {
      "name": "blue_group",
      "weightType": "fix",
      "stickiness": "custom.context.field",
      "payload": {
        "type": "json",
        "value": "{\"color\": \"red\"}"
      }
    }
  ],
  "segments": [
    1,
    2
  ]
}