Clone a feature flag

POST

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

POST

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

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

1 {
2   "name": "disable-comments",
3   "type": "kill-switch",
4   "description": "Controls disabling of the comments section in case of an incident",
5   "archived": true,
6   "project": "dx-squad",
7   "enabled": true,
8   "stale": false,
9   "favorite": true,
10   "impressionData": false,
11   "createdAt": "2023-01-28T15:21:39.975Z",
12   "createdBy": {
13     "id": 123,
14     "name": "User",
15     "imageUrl": "https://example.com/242x200.png"
16   },
17   "archivedAt": "2023-01-29T15:21:39.975Z",
18   "environments": [
19     {
20       "name": "my-dev-env",
21       "enabled": true,
22       "featureName": "disable-comments",
23       "environment": "development",
24       "type": "development",
25       "sortOrder": 3,
26       "variantCount": 1.1,
27       "strategies": [
28         {
29           "name": "flexibleRollout",
30           "id": "6b5157cb-343a-41e7-bfa3-7b4ec3044840",
31           "title": "Gradual Rollout 25-Prod",
32           "disabled": false,
33           "featureName": "myAwesomeFeature",
34           "sortOrder": 9999,
35           "segments": [
36             1,
37             2
38           ],
39           "constraints": [
40             {
41               "contextName": "appName",
42               "operator": "IN",
43               "caseInsensitive": false,
44               "inverted": false,
45               "values": [
46                 "my-app",
47                 "my-other-app"
48               ],
49               "value": "my-app"
50             }
51           ],
52           "variants": [
53             {
54               "name": "blue_group",
55               "weight": 1,
56               "weightType": "fix",
57               "stickiness": "custom.context.field",
58               "payload": {
59                 "type": "json",
60                 "value": "{\"color\": \"red\"}"
61               }
62             }
63           ],
64           "parameters": {}
65         }
66       ],
67       "variants": [
68         {
69           "name": "blue_group",
70           "weight": 1.1,
71           "weightType": "variable",
72           "stickiness": "custom.context.field",
73           "payload": {
74             "type": "json",
75             "value": "{\"color\": \"red\"}"
76           },
77           "overrides": [
78             {
79               "contextName": "userId",
80               "values": [
81                 "red",
82                 "blue"
83               ]
84             }
85           ]
86         }
87       ],
88       "changeRequestIds": [
89         1.1
90       ],
91       "milestoneName": "Phase One",
92       "milestoneOrder": 0,
93       "totalMilestones": 0,
94       "lastSeenAt": "2023-01-28T16:21:39.975Z",
95       "hasStrategies": true,
96       "hasEnabledStrategies": true,
97       "releasePlans": [
98         {
99           "id": "01JB9GGTGQYEQ9D40R17T3YVW2",
100           "discriminator": "plan",
101           "name": "My release plan",
102           "featureName": "my-feature",
103           "environment": "production",
104           "createdByUserId": 53,
105           "createdAt": "2022-01-01T00:00:00Z",
106           "milestones": [
107             {
108               "id": "01JB9GGTGQYEQ9D40R17T3YVW1",
109               "name": "My milestone",
110               "sortOrder": 1,
111               "releasePlanDefinitionId": "01JB9GGTGQYEQ9D40R17T3YVW2",
112               "startedAt": "2024-01-01T00:00:00.000Z",
113               "transitionCondition": {
114                 "intervalMinutes": 30
115               },
116               "progressionExecutedAt": "2024-01-01T00:00:00.000Z",
117               "pausedAt": "2024-01-01T00:00:00.000Z",
118               "strategies": [
119                 {
120                   "id": "01JB9GGTGQYEQ9D40R17T3YVW3",
121                   "milestoneId": "01JB9GGTGQYEQ9D40R17T3YVW1",
122                   "sortOrder": 9999,
123                   "name": "flexibleRollout",
124                   "strategyName": "flexibleRollout",
125                   "title": "Gradual Rollout 25-Prod",
126                   "parameters": {
127                     "groupId": "some_new",
128                     "rollout": "25",
129                     "stickiness": "sessionId"
130                   },
131                   "constraints": [
132                     {
133                       "contextName": "appName",
134                       "operator": "IN",
135                       "caseInsensitive": false,
136                       "inverted": false,
137                       "values": [
138                         "1",
139                         "2"
140                       ]
141                     }
142                   ],
143                   "variants": [
144                     {
145                       "name": "blue_group",
146                       "weight": 1,
147                       "weightType": "fix",
148                       "stickiness": "custom.context.field",
149                       "payload": {
150                         "type": "json",
151                         "value": "{\"color\": \"red\"}"
152                       }
153                     }
154                   ],
155                   "segments": [
156                     1,
157                     2
158                   ],
159                   "disabled": false
160                 }
161               ]
162             }
163           ],
164           "releasePlanTemplateId": "01JB9GGTGQYEQ9D40R17T3YVW2",
165           "description": "This is my release plan",
166           "activeMilestoneId": "01JB9GGTGQYEQ9D40R17T3YVW1",
167           "safeguards": [
168             {
169               "id": "01JB9GGTGQYEQ9D40R17T3YVW1",
170               "action": {
171                 "type": "pauseReleasePlanProgressions",
172                 "id": "01JB9GGTGQYEQ9D40R17T3YVW2"
173               },
174               "triggerCondition": {
175                 "operator": ">",
176                 "threshold": 100
177               },
178               "impactMetric": {
179                 "id": "01JB9GGTGQYEQ9D40R17T3YVW1",
180                 "metricName": "unleash_counter_feature_toggle_usage_total",
181                 "timeRange": "day",
182                 "aggregationMode": "rps",
183                 "labelSelectors": {
184                   "environment": [
185                     "development"
186                   ],
187                   "project": [
188                     "default"
189                   ]
190                 },
191                 "source": "internal"
192               }
193             }
194           ]
195         }
196       ],
197       "safeguards": [
198         {
199           "id": "01JB9GGTGQYEQ9D40R17T3YVW1",
200           "action": {
201             "type": "disableFeatureEnvironment",
202             "featureName": "string",
203             "environment": "string",
204             "project": "string"
205           },
206           "triggerCondition": {
207             "operator": ">",
208             "threshold": 100
209           },
210           "impactMetric": {
211             "id": "01JB9GGTGQYEQ9D40R17T3YVW1",
212             "metricName": "unleash_counter_feature_toggle_usage_total",
213             "timeRange": "day",
214             "aggregationMode": "rps",
215             "labelSelectors": {
216               "environment": [
217                 "development"
218               ],
219               "project": [
220                 "default"
221               ]
222             },
223             "source": "internal"
224           }
225         }
226       ],
227       "yes": 974,
228       "no": 50
229     }
230   ],
231   "tags": [
232     {
233       "value": "a-tag-value",
234       "type": "simple",
235       "color": "#FFFFFF"
236     }
237   ],
238   "children": [
239     "some-feature"
240   ],
241   "lifecycle": {
242     "stage": "initial",
243     "enteredStageAt": "2023-01-28T15:21:39.975Z",
244     "status": "kept"
245   },
246   "dependencies": [
247     {
248       "feature": "some-feature",
249       "enabled": true,
250       "variants": [
251         "some-feature-blue-variant"
252       ]
253     }
254   ],
255   "collaborators": {
256     "users": [
257       {
258         "id": 123,
259         "name": "User",
260         "imageUrl": "https://example.com/242x200.png"
261       }
262     ]
263   },
264   "links": [
265     {
266       "id": "01JTJNCJ5XVP2KPJFA03YRBZCA",
267       "url": "https://github.com/search?q=cleanupReminder&type=code",
268       "title": "Github cleanup",
269       "feature": "disable-comments"
270     }
271   ]
272 }

Creates a copy of the specified feature flag. The copy can be created in any project.

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

{
  "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": {
                "intervalMinutes": 30
              },
              "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"
    }
  ]
}

Creates a copy of the specified feature flag. The copy can be created in any project.

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

cloneFeatureSchema

namestringRequired

The name of the new feature

replaceGroupIdbooleanOptional

Whether to use the new feature name as its group ID or not. Group ID is used for calculating stickiness. Defaults to true.

Response

featureSchema

namestring

Unique feature name

typestring

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

descriptionstring or null

Detailed description of the feature

archivedboolean

true if the feature is archived

projectstring

Name of the project the feature belongs to

enabledboolean

true if the feature is enabled, otherwise false.

staleboolean

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

favoriteboolean

true if the feature was favorited, otherwise false.

impressionDataboolean

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

createdAtstring or nullformat: "date-time"

The date the feature was created

createdByobject

User who created the feature flag

archivedAtstring or nullformat: "date-time"

The date the feature was archived

environmentslist of objects

The list of environments where the feature can be used

tagslist of objects or null

The list of feature tags

childrenlist of strings

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

lifecycleobject

Current lifecycle stage of the feature

dependencieslist of objects

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

collaboratorsobject

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

linkslist of objects

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

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

1	{
2	"name": "disable-comments",
3	"type": "kill-switch",
4	"description": "Controls disabling of the comments section in case of an incident",
5	"archived": true,
6	"project": "dx-squad",
7	"enabled": true,
8	"stale": false,
9	"favorite": true,
10	"impressionData": false,
11	"createdAt": "2023-01-28T15:21:39.975Z",
12	"createdBy": {
13	"id": 123,
14	"name": "User",
15	"imageUrl": "https://example.com/242x200.png"
16	},
17	"archivedAt": "2023-01-29T15:21:39.975Z",
18	"environments": [
19	{
20	"name": "my-dev-env",
21	"enabled": true,
22	"featureName": "disable-comments",
23	"environment": "development",
24	"type": "development",
25	"sortOrder": 3,
26	"variantCount": 1.1,
27	"strategies": [
28	{
29	"name": "flexibleRollout",
30	"id": "6b5157cb-343a-41e7-bfa3-7b4ec3044840",
31	"title": "Gradual Rollout 25-Prod",
32	"disabled": false,
33	"featureName": "myAwesomeFeature",
34	"sortOrder": 9999,
35	"segments": [
36	1,
37	2
38	],
39	"constraints": [
40	{
41	"contextName": "appName",
42	"operator": "IN",
43	"caseInsensitive": false,
44	"inverted": false,
45	"values": [
46	"my-app",
47	"my-other-app"
48	],
49	"value": "my-app"
50	}
51	],
52	"variants": [
53	{
54	"name": "blue_group",
55	"weight": 1,
56	"weightType": "fix",
57	"stickiness": "custom.context.field",
58	"payload": {
59	"type": "json",
60	"value": "{\"color\": \"red\"}"
61	}
62	}
63	],
64	"parameters": {}
65	}
66	],
67	"variants": [
68	{
69	"name": "blue_group",
70	"weight": 1.1,
71	"weightType": "variable",
72	"stickiness": "custom.context.field",
73	"payload": {
74	"type": "json",
75	"value": "{\"color\": \"red\"}"
76	},
77	"overrides": [
78	{
79	"contextName": "userId",
80	"values": [
81	"red",
82	"blue"
83	]
84	}
85	]
86	}
87	],
88	"changeRequestIds": [
89	1.1
90	],
91	"milestoneName": "Phase One",
92	"milestoneOrder": 0,
93	"totalMilestones": 0,
94	"lastSeenAt": "2023-01-28T16:21:39.975Z",
95	"hasStrategies": true,
96	"hasEnabledStrategies": true,
97	"releasePlans": [
98	{
99	"id": "01JB9GGTGQYEQ9D40R17T3YVW2",
100	"discriminator": "plan",
101	"name": "My release plan",
102	"featureName": "my-feature",
103	"environment": "production",
104	"createdByUserId": 53,
105	"createdAt": "2022-01-01T00:00:00Z",
106	"milestones": [
107	{
108	"id": "01JB9GGTGQYEQ9D40R17T3YVW1",
109	"name": "My milestone",
110	"sortOrder": 1,
111	"releasePlanDefinitionId": "01JB9GGTGQYEQ9D40R17T3YVW2",
112	"startedAt": "2024-01-01T00:00:00.000Z",
113	"transitionCondition": {
114	"intervalMinutes": 30
115	},
116	"progressionExecutedAt": "2024-01-01T00:00:00.000Z",
117	"pausedAt": "2024-01-01T00:00:00.000Z",
118	"strategies": [
119	{
120	"id": "01JB9GGTGQYEQ9D40R17T3YVW3",
121	"milestoneId": "01JB9GGTGQYEQ9D40R17T3YVW1",
122	"sortOrder": 9999,
123	"name": "flexibleRollout",
124	"strategyName": "flexibleRollout",
125	"title": "Gradual Rollout 25-Prod",
126	"parameters": {
127	"groupId": "some_new",
128	"rollout": "25",
129	"stickiness": "sessionId"
130	},
131	"constraints": [
132	{
133	"contextName": "appName",
134	"operator": "IN",
135	"caseInsensitive": false,
136	"inverted": false,
137	"values": [
138	"1",
139	"2"
140	]
141	}
142	],
143	"variants": [
144	{
145	"name": "blue_group",
146	"weight": 1,
147	"weightType": "fix",
148	"stickiness": "custom.context.field",
149	"payload": {
150	"type": "json",
151	"value": "{\"color\": \"red\"}"
152	}
153	}
154	],
155	"segments": [
156	1,
157	2
158	],
159	"disabled": false
160	}
161	]
162	}
163	],
164	"releasePlanTemplateId": "01JB9GGTGQYEQ9D40R17T3YVW2",
165	"description": "This is my release plan",
166	"activeMilestoneId": "01JB9GGTGQYEQ9D40R17T3YVW1",
167	"safeguards": [
168	{
169	"id": "01JB9GGTGQYEQ9D40R17T3YVW1",
170	"action": {
171	"type": "pauseReleasePlanProgressions",
172	"id": "01JB9GGTGQYEQ9D40R17T3YVW2"
173	},
174	"triggerCondition": {
175	"operator": ">",
176	"threshold": 100
177	},
178	"impactMetric": {
179	"id": "01JB9GGTGQYEQ9D40R17T3YVW1",
180	"metricName": "unleash_counter_feature_toggle_usage_total",
181	"timeRange": "day",
182	"aggregationMode": "rps",
183	"labelSelectors": {
184	"environment": [
185	"development"
186	],
187	"project": [
188	"default"
189	]
190	},
191	"source": "internal"
192	}
193	}
194	]
195	}
196	],
197	"safeguards": [
198	{
199	"id": "01JB9GGTGQYEQ9D40R17T3YVW1",
200	"action": {
201	"type": "disableFeatureEnvironment",
202	"featureName": "string",
203	"environment": "string",
204	"project": "string"
205	},
206	"triggerCondition": {
207	"operator": ">",
208	"threshold": 100
209	},
210	"impactMetric": {
211	"id": "01JB9GGTGQYEQ9D40R17T3YVW1",
212	"metricName": "unleash_counter_feature_toggle_usage_total",
213	"timeRange": "day",
214	"aggregationMode": "rps",
215	"labelSelectors": {
216	"environment": [
217	"development"
218	],
219	"project": [
220	"default"
221	]
222	},
223	"source": "internal"
224	}
225	}
226	],
227	"yes": 974,
228	"no": 50
229	}
230	],
231	"tags": [
232	{
233	"value": "a-tag-value",
234	"type": "simple",
235	"color": "#FFFFFF"
236	}
237	],
238	"children": [
239	"some-feature"
240	],
241	"lifecycle": {
242	"stage": "initial",
243	"enteredStageAt": "2023-01-28T15:21:39.975Z",
244	"status": "kept"
245	},
246	"dependencies": [
247	{
248	"feature": "some-feature",
249	"enabled": true,
250	"variants": [
251	"some-feature-blue-variant"
252	]
253	}
254	],
255	"collaborators": {
256	"users": [
257	{
258	"id": 123,
259	"name": "User",
260	"imageUrl": "https://example.com/242x200.png"
261	}
262	]
263	},
264	"links": [
265	{
266	"id": "01JTJNCJ5XVP2KPJFA03YRBZCA",
267	"url": "https://github.com/search?q=cleanupReminder&type=code",
268	"title": "Github cleanup",
269	"feature": "disable-comments"
270	}
271	]
272	}