Create View

POST

/api/v2/projects/:projectKey/views

POST

/api/v2/projects/:projectKey/views

1 import requests
2 
3 url = "https://app.launchdarkly.com/api/v2/projects/default/views"
4 
5 payload = {
6     "key": "key",
7     "name": "name",
8     "description": "",
9     "generateSdkKeys": False,
10     "maintainerId": "maintainerId",
11     "maintainerTeamKey": "maintainerTeamKey",
12     "tags": ["tags", "tags"]
13 }
14 headers = {
15     "LD-API-Version": "beta",
16     "Authorization": "<apiKey>",
17     "Content-Type": "application/json"
18 }
19 
20 response = requests.post(url, json=payload, headers=headers)
21 
22 print(response.json())

Try it

1 {
2   "id": "id",
3   "accountId": "accountId",
4   "projectId": "projectId",
5   "projectKey": "projectKey",
6   "key": "key",
7   "name": "name",
8   "description": "description",
9   "generateSdkKeys": true,
10   "version": 0,
11   "tags": [
12     "tags",
13     "tags"
14   ],
15   "createdAt": 6,
16   "updatedAt": 1,
17   "archived": false,
18   "deleted": false,
19   "_access": {
20     "denied": [
21       {
22         "action": "action",
23         "reason": {
24           "effect": "allow",
25           "resources": [
26             "proj/*:env/*;qa_*:/flag/*"
27           ],
28           "notResources": [
29             "notResources",
30             "notResources"
31           ],
32           "actions": [
33             "*"
34           ],
35           "notActions": [
36             "notActions",
37             "notActions"
38           ],
39           "role_name": "role_name"
40         }
41       },
42       {
43         "action": "action",
44         "reason": {
45           "effect": "allow",
46           "resources": [
47             "proj/*:env/*;qa_*:/flag/*"
48           ],
49           "notResources": [
50             "notResources",
51             "notResources"
52           ],
53           "actions": [
54             "*"
55           ],
56           "notActions": [
57             "notActions",
58             "notActions"
59           ],
60           "role_name": "role_name"
61         }
62       }
63     ],
64     "allowed": [
65       {
66         "action": "action",
67         "reason": {
68           "effect": "allow",
69           "resources": [
70             "proj/*:env/*;qa_*:/flag/*"
71           ],
72           "notResources": [
73             "notResources",
74             "notResources"
75           ],
76           "actions": [
77             "*"
78           ],
79           "notActions": [
80             "notActions",
81             "notActions"
82           ],
83           "role_name": "role_name"
84         }
85       },
86       {
87         "action": "action",
88         "reason": {
89           "effect": "allow",
90           "resources": [
91             "proj/*:env/*;qa_*:/flag/*"
92           ],
93           "notResources": [
94             "notResources",
95             "notResources"
96           ],
97           "actions": [
98             "*"
99           ],
100           "notActions": [
101             "notActions",
102             "notActions"
103           ],
104           "role_name": "role_name"
105         }
106       }
107     ]
108   },
109   "_links": {
110     "self": {
111       "href": "href",
112       "type": "type"
113     },
114     "parent": {
115       "href": "href",
116       "type": "type"
117     }
118   },
119   "archivedAt": 5,
120   "deletedAt": 5,
121   "maintainer": {
122     "id": "id",
123     "kind": "kind",
124     "maintainerMember": {
125       "id": "id",
126       "email": "email",
127       "role": "role",
128       "firstName": "firstName",
129       "lastName": "lastName"
130     },
131     "maintainerTeam": {
132       "id": "id",
133       "key": "key",
134       "name": "name"
135     }
136   },
137   "flagsSummary": {
138     "count": 2,
139     "linkedFlags": {
140       "items": [
141         {
142           "key": "key",
143           "name": "name",
144           "links": {
145             "self": {
146               "href": "href",
147               "type": "type"
148             }
149           }
150         },
151         {
152           "key": "key",
153           "name": "name",
154           "links": {
155             "self": {
156               "href": "href",
157               "type": "type"
158             }
159           }
160         }
161       ],
162       "totalCount": 7
163     }
164   },
165   "segmentsSummary": {
166     "count": 9,
167     "linkedSegments": {
168       "items": [
169         {
170           "key": "key",
171           "name": "name",
172           "environmentId": "environmentId",
173           "links": {
174             "self": {
175               "href": "href",
176               "type": "type"
177             }
178           }
179         },
180         {
181           "key": "key",
182           "name": "name",
183           "environmentId": "environmentId",
184           "links": {
185             "self": {
186               "href": "href",
187               "type": "type"
188             }
189           }
190         }
191       ],
192       "totalCount": 3
193     }
194   },
195   "parents": {
196     "items": [
197       {
198         "_id": "_id",
199         "key": "key",
200         "name": "name",
201         "links": {
202           "self": {
203             "href": "href",
204             "type": "type"
205           }
206         }
207       },
208       {
209         "_id": "_id",
210         "key": "key",
211         "name": "name",
212         "links": {
213           "self": {
214             "href": "href",
215             "type": "type"
216           }
217         }
218       }
219     ],
220     "totalCount": 2
221   },
222   "children": {
223     "items": [
224       {
225         "_id": "_id",
226         "key": "key",
227         "name": "name",
228         "links": {
229           "self": {
230             "href": "href",
231             "type": "type"
232           }
233         }
234       },
235       {
236         "_id": "_id",
237         "key": "key",
238         "name": "name",
239         "links": {
240           "self": {
241             "href": "href",
242             "type": "type"
243           }
244         }
245       }
246     ],
247     "totalCount": 2
248   },
249   "all_flags": {
250     "items": [
251       {
252         "key": "key",
253         "name": "name",
254         "directlyAssociated": true,
255         "sourceViews": [
256           "sourceViews",
257           "sourceViews"
258         ]
259       },
260       {
261         "key": "key",
262         "name": "name",
263         "directlyAssociated": true,
264         "sourceViews": [
265           "sourceViews",
266           "sourceViews"
267         ]
268       }
269     ],
270     "totalCount": 4
271   },
272   "all_segments": {
273     "items": [
274       {
275         "key": "key",
276         "name": "name",
277         "environmentId": "environmentId",
278         "directlyAssociated": true,
279         "sourceViews": [
280           "sourceViews",
281           "sourceViews"
282         ]
283       },
284       {
285         "key": "key",
286         "name": "name",
287         "environmentId": "environmentId",
288         "directlyAssociated": true,
289         "sourceViews": [
290           "sourceViews",
291           "sourceViews"
292         ]
293       }
294     ],
295     "totalCount": 7
296   }
297 }

Create a new View in the given project.

Path parameters

projectKeystringRequired

Request

This endpoint expects an object.

keystringRequired

Unique key for the view within the account/project

namestringRequired

Human-readable name for the view

descriptionstringOptionalDefaults to

Optional detailed description of the view

generateSdkKeysbooleanOptionalDefaults to false

Whether to generate SDK keys for this view

maintainerIdstringOptional

Member ID of the maintainer for this view. Only one of maintainerId or maintainerTeamKey can be specified.

maintainerTeamKeystringOptional

Key of the maintainer team for this view. Only one of maintainerId or maintainerTeamKey can be specified.

tagslist of stringsOptional

Tags associated with this view

Response

Successful response

idstring

Unique ID of this view

accountIdstring

ID of the account that owns this view

projectIdstring

ID of the project this view belongs to

projectKeystring

Key of the project this view belongs to

keystring

Unique key for the view within the account/project

namestring

Human-readable name for the view

descriptionstring

Optional detailed description of the view

generateSdkKeysboolean

Whether to generate SDK keys for this view (defaults to false)

versioninteger

Version number for tracking changes

tagslist of strings

Tags associated with this view

createdAtlong

updatedAtlong

archivedboolean

Whether this view is archived

deletedboolean

Whether this view is deleted

_accessobject or null

_linksobject or null

The location and content type of related resources

archivedAtlong or null

deletedAtlong or null

maintainerobject or null

flagsSummaryobject or null

segmentsSummaryobject or null

parentsobject or null

childrenobject or null

all_flagsobject or null

all_segmentsobject or null

Create View

Path parameters

Headers

Request

Response

Errors