Add a strategy to a feature flag | Unleash Documentation

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

{
  "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": {}
}

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

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

{
  "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": {}
}

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

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

environmentstringRequired

Request

createFeatureStrategySchema

namestringRequired

The name of the strategy type

titlestring or nullOptional

A descriptive title for the strategy

disabledboolean or nullOptional

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

sortOrderdoubleOptional

The order of the strategy in the list

constraintslist of objectsOptional

A list of the constraints attached to the strategy. See https://docs.getunleash.io/concepts/activation-strategies#constraints

variantslist of objectsOptional

Strategy level variants

parametersmap from strings to stringsOptional

An object containing the parameters for the strategy

segmentslist of doublesOptional

Ids of segments to use for this strategy

Response

featureStrategySchema

namestring

The name or type of strategy

idstring

A uuid for the feature strategy

titlestring or null

A descriptive title for the strategy

disabledboolean or null

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

sortOrderdouble

The order of the strategy in the list

segmentslist of doubles

A list of segment ids attached to the strategy

constraintslist of objects

A list of the constraints attached to the strategy. See https://docs.getunleash.io/concepts/activation-strategies#constraints

variantslist of objects

Strategy level variants

parametersmap from strings to strings

A list of parameters for a strategy

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

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

1	{
2	"name": "flexibleRollout",
3	"id": "6b5157cb-343a-41e7-bfa3-7b4ec3044840",
4	"title": "Gradual Rollout 25-Prod",
5	"disabled": false,
6	"featureName": "myAwesomeFeature",
7	"sortOrder": 9999,
8	"segments": [
9	1,
10	2
11	],
12	"constraints": [
13	{
14	"contextName": "appName",
15	"operator": "IN",
16	"caseInsensitive": false,
17	"inverted": false,
18	"values": [
19	"my-app",
20	"my-other-app"
21	],
22	"value": "my-app"
23	}
24	],
25	"variants": [
26	{
27	"name": "blue_group",
28	"weight": 1,
29	"weightType": "fix",
30	"stickiness": "custom.context.field",
31	"payload": {
32	"type": "json",
33	"value": "{\"color\": \"red\"}"
34	}
35	}
36	],
37	"parameters": {}
38	}