Search features

GET

https://app.unleash-instance.example.com/api/admin/search/features

GET

/api/admin/search/features

1 import requests
2 
3 url = "https://app.unleash-instance.example.com/api/admin/search/features"
4 
5 headers = {"Authorization": "<apiKey>"}
6 
7 response = requests.get(url, headers=headers)
8 
9 print(response.json())

Try it

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

Search and filter by selected fields.

Authentication

Authorizationstring

API key needed to access this API

AuthorizationBearer

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

Query parameters

querystringOptional

The search query for the feature name or tag

projectstringOptionalformat: "^(IS|IS_NOT|IS_ANY_OF|IS_NONE_OF):(.*?)(,([a-zA-Z0-9_]+))*$"

Id of the project where search and filter is performed. The project id can be specified with an operator. The supported operators are IS, IS_NOT, IS_ANY_OF, IS_NONE_OF.

statestringOptionalformat: "^(IS|IS_NOT|IS_ANY_OF|IS_NONE_OF):(.*?)(,([a-zA-Z0-9_]+))*$"

The state of the feature active/stale. The state can be specified with an operator. The supported operators are IS, IS_NOT, IS_ANY_OF, IS_NONE_OF.

lifecyclestringOptionalformat: "^(IS|IS_NOT|IS_ANY_OF|IS_NONE_OF):(.*?)(,([a-zA-Z0-9_]+))*$"

The lifecycle stage of the feature. The stagee can be specified with an operator. The supported operators are IS, IS_NOT, IS_ANY_OF, IS_NONE_OF.

typestringOptionalformat: "^(IS|IS_NOT|IS_ANY_OF|IS_NONE_OF):(.*?)(,([a-zA-Z0-9_]+))*$"

The feature flag type to filter by. The type can be specified with an operator. The supported operators are IS, IS_NOT, IS_ANY_OF, IS_NONE_OF.

createdBystringOptionalformat: "^(IS|IS_NOT|IS_ANY_OF|IS_NONE_OF):(.*?)(,([a-zA-Z0-9_]+))*$"

The feature flag creator to filter by. The creators can be specified with an operator. The supported operators are IS, IS_NOT, IS_ANY_OF, IS_NONE_OF.

tagstringOptional

format: "^(INCLUDE|DO_NOT_INCLUDE|INCLUDE_ALL_OF|INCLUDE_ANY_OF|EXCLUDE_IF_ANY_OF|EXCLUDE_ALL):([^:,]+:.+?)(,\s*[^:,]+:.+?)*$"

The list of feature tags to filter by. Feature tag has to specify a type and a value joined with a colon.

segmentstringOptional

format: "^(INCLUDE|DO_NOT_INCLUDE|INCLUDE_ALL_OF|INCLUDE_ANY_OF|EXCLUDE_IF_ANY_OF|EXCLUDE_ALL):(.*?)(,([a-zA-Z0-9_]+))*$"

The list of segments with operators to filter by. The segment valid operators are INCLUDE, DO_NOT_INCLUDE, INCLUDE_ALL_OF, INCLUDE_ANY_OF, EXCLUDE_IF_ANY_OF, EXCLUDE_ALL.

statuslist of stringsOptional

The list of feature environment status to filter by. Feature environment has to specify a name and a status joined with a colon.

offsetstringOptional

The number of features to skip when returning a page. By default it is set to 0.

limitstringOptional

The number of feature environments to return in a page. By default it is set to 50.

sortBystringOptional

The field to sort the results by. By default it is set to "createdAt".

sortOrderenumOptional

The sort order for the sortBy. By default it is det to "asc".

Allowed values:

favoritesFirststringOptional

The flag to indicate if the favorite features should be returned first. By default it is set to false.

archivedstringOptionalformat: "^IS:(true|false)$"

Whether to get results for archived feature flags or active feature flags. If IS:true, Unleash will return only archived flags. If IS:false, it will return only active flags.

createdAtstringOptionalformat: "^(IS_BEFORE|IS_ON_OR_AFTER):\d{4}-\d{2}-\d{2}$"

The date the feature was created. The date can be specified with an operator. The supported operators are IS_BEFORE, IS_ON_OR_AFTER.

lastSeenAtstringOptionalformat: "^(IS_BEFORE|IS_ON_OR_AFTER):\d{4}-\d{2}-\d{2}$"

The date the feature was last seen from metrics. The date can be specified with an operator. The supported operators are IS_BEFORE, IS_ON_OR_AFTER.

Response

searchFeaturesSchema

featureslist of objects

The full list of features in this project matching search and filter criteria.

totaldouble or null

Total count of the features matching search and filter criteria

Authentication

Query parameters

Response

Errors