Features

Add a strategy to a feature flag

Add a strategy to a feature flag in the specified environment.

post/api/admin/projects/{projectId}/features/{featureName}/environments/{environment}/strategies

Path parameters

projectIdstring required

featureNamestring required

environmentstring required

Request body

namestring required

The name of the strategy type

titlestring nullable

A descriptive title for the strategy

disabledboolean nullable

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

sortOrdernumber

The order of the strategy in the list

parametersParametersSchema

A list of parameters for a strategy

segmentsnumber[]

Ids of segments to use for this strategy

Example request

{
  "name": "flexibleRollout",
  "title": "Gradual Rollout 25-Prod",
  "sortOrder": 9999,
  "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
  ]
}

Response

featureStrategySchema

idstring

A uuid for the feature strategy

namestring required

The name or type of strategy

titlestring nullable

A descriptive title for the strategy

disabledboolean nullable

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

featureNamestring

The name or feature the strategy is attached to

sortOrdernumber

The order of the strategy in the list

segmentsnumber[]

A list of segment ids attached to the strategy

parametersParametersSchema

A list of parameters for a strategy

Example response

{
  "id": "6b5157cb-343a-41e7-bfa3-7b4ec3044840",
  "name": "flexibleRollout",
  "title": "Gradual Rollout 25-Prod",
  "featureName": "myAwesomeFeature",
  "sortOrder": 9999,
  "segments": [
    1,
    2
  ],
  "constraints": [
    {
      "contextName": "appName",
      "operator": "IN",
      "values": [
        "my-app",
        "my-other-app"
      ],
      "value": "my-app"
    }
  ],
  "variants": [
    {
      "name": "blue_group",
      "weightType": "fix",
      "stickiness": "custom.context.field",
      "payload": {
        "type": "json",
        "value": "{\"color\": \"red\"}"
      }
    }
  ]
}

Changes

Changed in 2 of the 7 revisions of this API.133

Jul 31, 2026b2c3116e633e122See the full diff
- ▲
  the // request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ●
  added the new SEMVER_GTE enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new SEMVER_LTE enum value to the // response property for the response status
  response-property-enum-value-added
- ○
  added the new SEMVER_GTE enum value to the request property //
  request-property-enum-value-added
- ○
  added the new SEMVER_LTE enum value to the request property //
  request-property-enum-value-added
Jun 15, 2026774670258f0411See the full diff
- ●
  added the new REGEX enum value to the // response property for the response status
  response-property-enum-value-added
- ○
  added the new REGEX enum value to the request property //
  request-property-enum-value-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history