Get approval request

GET

/api/v2/approval-requests/:id

GET

/api/v2/approval-requests/:id

$ curl https://app.launchdarkly.com/api/v2/approval-requests/id \
>      -H "Authorization: <apiKey>"

1 {
2   "_id": "12ab3c45de678910abc12345",
3   "_version": 1,
4   "creationDate": 1654104600000,
5   "serviceKind": "launchdarkly",
6   "reviewStatus": "pending",
7   "allReviews": [
8     {
9       "_id": "12ab3c45de678910abc12345",
10       "kind": "approve",
11       "creationDate": 1653606981113,
12       "comment": "Approved!",
13       "memberId": "12ab3c45de678910abc12345",
14       "serviceTokenId": "12ab3c45de678910abc12345"
15     }
16   ],
17   "notifyMemberIds": [
18     "1234a56b7c89d012345e678f"
19   ],
20   "status": "pending",
21   "instructions": [
22     "[{\"kind\": \"turnFlagOn\"}]"
23   ],
24   "conflicts": [
25     {
26       "instruction": {},
27       "reason": "string"
28     }
29   ],
30   "_links": {},
31   "requestorId": "12ab3c45de678910abc12345",
32   "description": "example: request approval from someone",
33   "appliedDate": 1654104600000,
34   "appliedByMemberId": "1234a56b7c89d012345e678f",
35   "appliedByServiceTokenId": "1234a56b7c89d012345e678f",
36   "executionDate": 1654104600000,
37   "operatingOnId": "12ab3c45de678910abc12345",
38   "integrationMetadata": {
39     "externalId": "string",
40     "externalStatus": {
41       "display": "string",
42       "value": "string"
43     },
44     "externalUrl": "string",
45     "lastChecked": 1
46   },
47   "source": {
48     "key": "source-flag-key-123abc",
49     "version": 1
50   },
51   "customWorkflowMetadata": {
52     "name": "Example workflow name",
53     "stage": {
54       "index": 0,
55       "name": "Stage 1"
56     }
57   },
58   "resourceId": "string",
59   "approvalSettings": {
60     "required": true,
61     "bypassApprovalsForPendingChanges": false,
62     "minNumApprovals": 1,
63     "canReviewOwnRequest": false,
64     "canApplyDeclinedChanges": true,
65     "serviceKind": "launchdarkly",
66     "serviceConfig": {},
67     "requiredApprovalTags": [
68       "require-approval"
69     ],
70     "autoApplyApprovedChanges": true,
71     "serviceKindConfigurationId": "1ef45a85-218f-4428-a8b2-a97e5f56c258"
72   },
73   "project": {
74     "_links": {
75       "environments": {
76         "href": "/api/v2/projects/my-project/environments",
77         "type": "application/json"
78       },
79       "self": {
80         "href": "/api/v2/projects/my-project",
81         "type": "application/json"
82       }
83     },
84     "_id": "57be1db38b75bf0772d11383",
85     "key": "project-key-123abc",
86     "includeInSnippetByDefault": true,
87     "name": "My Project",
88     "tags": [
89       "ops"
90     ],
91     "defaultClientSideAvailability": {
92       "usingMobileKey": true,
93       "usingEnvironmentId": true
94     },
95     "_access": {
96       "denied": [
97         {
98           "action": "string",
99           "reason": {
100             "effect": "allow",
101             "resources": [
102               "proj/*:env/*;qa_*:/flag/*"
103             ],
104             "notResources": [
105               "string"
106             ],
107             "actions": [
108               "*"
109             ],
110             "notActions": [
111               "string"
112             ],
113             "role_name": "string"
114           }
115         }
116       ],
117       "allowed": [
118         {
119           "action": "string",
120           "reason": {
121             "effect": "allow",
122             "resources": [
123               "proj/*:env/*;qa_*:/flag/*"
124             ],
125             "notResources": [
126               "string"
127             ],
128             "actions": [
129               "*"
130             ],
131             "notActions": [
132               "string"
133             ],
134             "role_name": "string"
135           }
136         }
137       ]
138     },
139     "defaultReleasePipelineKey": "string",
140     "environments": {
141       "items": [
142         {
143           "_links": {
144             "self": {
145               "href": "/api/v2/projects/my-project/environments/my-environment",
146               "type": "application/json"
147             }
148           },
149           "_id": "57be1db38b75bf0772d11384",
150           "key": "environment-key-123abc",
151           "name": "My Environment",
152           "apiKey": "sdk-xxx",
153           "mobileKey": "mob-xxx",
154           "color": "F5A623",
155           "defaultTtl": 5,
156           "secureMode": true,
157           "defaultTrackEvents": false,
158           "requireComments": true,
159           "confirmChanges": true,
160           "tags": [
161             "ops"
162           ],
163           "critical": true,
164           "_access": {
165             "denied": [
166               {
167                 "action": "string",
168                 "reason": {
169                   "effect": "allow",
170                   "resources": [
171                     "proj/*:env/*;qa_*:/flag/*"
172                   ],
173                   "notResources": [
174                     "string"
175                   ],
176                   "actions": [
177                     "*"
178                   ],
179                   "notActions": [
180                     "string"
181                   ],
182                   "role_name": "string"
183                 }
184               }
185             ],
186             "allowed": [
187               {
188                 "action": "string",
189                 "reason": {
190                   "effect": "allow",
191                   "resources": [
192                     "proj/*:env/*;qa_*:/flag/*"
193                   ],
194                   "notResources": [
195                     "string"
196                   ],
197                   "actions": [
198                     "*"
199                   ],
200                   "notActions": [
201                     "string"
202                   ],
203                   "role_name": "string"
204                 }
205               }
206             ]
207           },
208           "approvalSettings": {
209             "required": true,
210             "bypassApprovalsForPendingChanges": false,
211             "minNumApprovals": 1,
212             "canReviewOwnRequest": false,
213             "canApplyDeclinedChanges": true,
214             "serviceKind": "launchdarkly",
215             "serviceConfig": {},
216             "requiredApprovalTags": [
217               "require-approval"
218             ],
219             "autoApplyApprovedChanges": true,
220             "serviceKindConfigurationId": "1ef45a85-218f-4428-a8b2-a97e5f56c258"
221           },
222           "resourceApprovalSettings": {}
223         }
224       ],
225       "_links": {},
226       "totalCount": 2
227     }
228   },
229   "environments": [
230     {
231       "_links": {
232         "self": {
233           "href": "/api/v2/projects/my-project/environments/my-environment",
234           "type": "application/json"
235         }
236       },
237       "_id": "57be1db38b75bf0772d11384",
238       "key": "environment-key-123abc",
239       "name": "My Environment",
240       "apiKey": "sdk-xxx",
241       "mobileKey": "mob-xxx",
242       "color": "F5A623",
243       "defaultTtl": 5,
244       "secureMode": true,
245       "defaultTrackEvents": false,
246       "requireComments": true,
247       "confirmChanges": true,
248       "tags": [
249         "ops"
250       ],
251       "critical": true,
252       "_access": {
253         "denied": [
254           {
255             "action": "string",
256             "reason": {
257               "effect": "allow",
258               "resources": [
259                 "proj/*:env/*;qa_*:/flag/*"
260               ],
261               "notResources": [
262                 "string"
263               ],
264               "actions": [
265                 "*"
266               ],
267               "notActions": [
268                 "string"
269               ],
270               "role_name": "string"
271             }
272           }
273         ],
274         "allowed": [
275           {
276             "action": "string",
277             "reason": {
278               "effect": "allow",
279               "resources": [
280                 "proj/*:env/*;qa_*:/flag/*"
281               ],
282               "notResources": [
283                 "string"
284               ],
285               "actions": [
286                 "*"
287               ],
288               "notActions": [
289                 "string"
290               ],
291               "role_name": "string"
292             }
293           }
294         ]
295       },
296       "approvalSettings": {
297         "required": true,
298         "bypassApprovalsForPendingChanges": false,
299         "minNumApprovals": 1,
300         "canReviewOwnRequest": false,
301         "canApplyDeclinedChanges": true,
302         "serviceKind": "launchdarkly",
303         "serviceConfig": {},
304         "requiredApprovalTags": [
305           "require-approval"
306         ],
307         "autoApplyApprovedChanges": true,
308         "serviceKindConfigurationId": "1ef45a85-218f-4428-a8b2-a97e5f56c258"
309       },
310       "resourceApprovalSettings": {}
311     }
312   ],
313   "flag": {
314     "name": "My Flag",
315     "kind": "boolean",
316     "key": "flag-key-123abc",
317     "_version": 1,
318     "creationDate": 1494437420312,
319     "variations": [
320       {
321         "value": null,
322         "_id": "e432f62b-55f6-49dd-a02f-eb24acf39d05"
323       },
324       {
325         "value": null,
326         "_id": "a00bf58d-d252-476c-b915-15a74becacb4"
327       }
328     ],
329     "temporary": true,
330     "tags": [
331       "example-tag"
332     ],
333     "_links": {
334       "parent": {
335         "href": "/api/v2/flags/my-project",
336         "type": "application/json"
337       },
338       "self": {
339         "href": "/api/v2/flags/my-project/my-flag",
340         "type": "application/json"
341       }
342     },
343     "customProperties": "{\"jira.issues\":{\"name\":\"Jira issues\",\"value\":[\"is-123\",\"is-456\"]}}",
344     "archived": false,
345     "description": "This flag controls the example widgets",
346     "clientSideAvailability": {},
347     "maintainerId": "569f183514f4432160000007",
348     "_maintainer": {
349       "_links": {
350         "self": {
351           "href": "/api/v2/members/569f183514f4432160000007",
352           "type": "application/json"
353         }
354       },
355       "_id": "569f183514f4432160000007",
356       "role": "admin",
357       "email": "ariel@acme.com",
358       "firstName": "Ariel",
359       "lastName": "Flores"
360     },
361     "archivedDate": 1494437420312,
362     "defaults": {
363       "onVariation": 0,
364       "offVariation": 1
365     },
366     "includeInSnippet": true
367   },
368   "resource": {
369     "kind": "flag",
370     "aiConfig": {
371       "key": "aiconfig-key-123abc",
372       "name": "AI Config 1"
373     },
374     "experiment": {
375       "key": "experiment-key-123abc",
376       "name": "My Experiment",
377       "_access": {
378         "denied": [
379           {
380             "action": "string",
381             "reason": {
382               "effect": "allow",
383               "resources": [
384                 "proj/*:env/*;qa_*:/flag/*"
385               ],
386               "notResources": [
387                 "string"
388               ],
389               "actions": [
390                 "*"
391               ],
392               "notActions": [
393                 "string"
394               ],
395               "role_name": "string"
396             }
397           }
398         ],
399         "allowed": [
400           {
401             "action": "string",
402             "reason": {
403               "effect": "allow",
404               "resources": [
405                 "proj/*:env/*;qa_*:/flag/*"
406               ],
407               "notResources": [
408                 "string"
409               ],
410               "actions": [
411                 "*"
412               ],
413               "notActions": [
414                 "string"
415               ],
416               "role_name": "string"
417             }
418           }
419         ]
420       }
421     },
422     "flag": {
423       "name": "My Flag",
424       "kind": "boolean",
425       "key": "flag-key-123abc",
426       "_version": 1,
427       "creationDate": 1494437420312,
428       "variations": [
429         {
430           "value": null,
431           "_id": "e432f62b-55f6-49dd-a02f-eb24acf39d05"
432         },
433         {
434           "value": null,
435           "_id": "a00bf58d-d252-476c-b915-15a74becacb4"
436         }
437       ],
438       "temporary": true,
439       "tags": [
440         "example-tag"
441       ],
442       "_links": {
443         "parent": {
444           "href": "/api/v2/flags/my-project",
445           "type": "application/json"
446         },
447         "self": {
448           "href": "/api/v2/flags/my-project/my-flag",
449           "type": "application/json"
450         }
451       },
452       "customProperties": "{\"jira.issues\":{\"name\":\"Jira issues\",\"value\":[\"is-123\",\"is-456\"]}}",
453       "archived": false,
454       "description": "This flag controls the example widgets",
455       "clientSideAvailability": {},
456       "maintainerId": "569f183514f4432160000007",
457       "_maintainer": {
458         "_links": {
459           "self": {
460             "href": "/api/v2/members/569f183514f4432160000007",
461             "type": "application/json"
462           }
463         },
464         "_id": "569f183514f4432160000007",
465         "role": "admin",
466         "email": "ariel@acme.com",
467         "firstName": "Ariel",
468         "lastName": "Flores"
469       },
470       "archivedDate": 1494437420312,
471       "defaults": {
472         "onVariation": 0,
473         "offVariation": 1
474       },
475       "includeInSnippet": true
476     },
477     "segment": {
478       "name": "Example segment",
479       "tags": [
480         "testing"
481       ],
482       "creationDate": 1654104600000,
483       "lastModifiedDate": 1654104600000,
484       "key": "segment-key-123abc",
485       "_links": {},
486       "rules": [
487         {
488           "clauses": [
489             {
490               "attribute": "email",
491               "op": "endsWith",
492               "values": [
493                 ".edu"
494               ],
495               "negate": false,
496               "_id": "12ab3c45de678910fab12345"
497             }
498           ],
499           "_id": "1234a56b7c89d012345e678f"
500         }
501       ],
502       "version": 1,
503       "deleted": false,
504       "generation": 1,
505       "description": "Bundle our sample customers together",
506       "included": [
507         "user-key-123abc"
508       ],
509       "excluded": [
510         "user-key-123abc"
511       ],
512       "includedContexts": [
513         {
514           "values": [
515             "string"
516           ],
517           "contextKind": "string"
518         }
519       ],
520       "excludedContexts": [
521         {
522           "values": [
523             "string"
524           ],
525           "contextKind": "string"
526         }
527       ],
528       "_access": {
529         "denied": [
530           {
531             "action": "string",
532             "reason": {
533               "effect": "allow",
534               "resources": [
535                 "proj/*:env/*;qa_*:/flag/*"
536               ],
537               "notResources": [
538                 "string"
539               ],
540               "actions": [
541                 "*"
542               ],
543               "notActions": [
544                 "string"
545               ],
546               "role_name": "string"
547             }
548           }
549         ],
550         "allowed": [
551           {
552             "action": "string",
553             "reason": {
554               "effect": "allow",
555               "resources": [
556                 "proj/*:env/*;qa_*:/flag/*"
557               ],
558               "notResources": [
559                 "string"
560               ],
561               "actions": [
562                 "*"
563               ],
564               "notActions": [
565                 "string"
566               ],
567               "role_name": "string"
568             }
569           }
570         ]
571       },
572       "_flags": [
573         {
574           "name": "Example flag",
575           "key": "flag-key-123abc",
576           "_links": {},
577           "_site": {
578             "href": "string",
579             "type": "string"
580           }
581         }
582       ],
583       "unbounded": false,
584       "unboundedContextKind": "string",
585       "_unboundedMetadata": {
586         "envId": "string",
587         "segmentId": "string",
588         "version": 1,
589         "includedCount": 1,
590         "excludedCount": 1,
591         "lastModified": 1,
592         "deleted": true
593       },
594       "_external": "amplitude",
595       "_externalLink": "https://analytics.amplitude.com/org/1234/cohort/123abc",
596       "_importInProgress": false
597     }
598   }
599 }

Get an approval request by approval request ID. ### Expanding approval response LaunchDarkly supports the `expand` query param to include additional fields in the response, with the following fields: - `environments` includes the environments the approval request relates to - `flag` includes the flag the approval request belongs to - `project` includes the project the approval request belongs to - `resource` includes details on the resource (flag or segment) the approval request relates to For example, `expand=project,flag` includes the `project` and `flag` fields in the response.

curl https://app.launchdarkly.com/api/v2/approval-requests/id \
     -H "Authorization: <apiKey>"

{
  "_id": "12ab3c45de678910abc12345",
  "_version": 1,
  "creationDate": 1654104600000,
  "serviceKind": "launchdarkly",
  "reviewStatus": "pending",
  "allReviews": [
    {
      "_id": "12ab3c45de678910abc12345",
      "kind": "approve",
      "creationDate": 1653606981113,
      "comment": "Approved!",
      "memberId": "12ab3c45de678910abc12345",
      "serviceTokenId": "12ab3c45de678910abc12345"
    }
  ],
  "notifyMemberIds": [
    "1234a56b7c89d012345e678f"
  ],
  "status": "pending",
  "instructions": [
    "[{\"kind\": \"turnFlagOn\"}]"
  ],
  "conflicts": [
    {
      "instruction": {},
      "reason": "string"
    }
  ],
  "_links": {},
  "requestorId": "12ab3c45de678910abc12345",
  "description": "example: request approval from someone",
  "appliedDate": 1654104600000,
  "appliedByMemberId": "1234a56b7c89d012345e678f",
  "appliedByServiceTokenId": "1234a56b7c89d012345e678f",
  "executionDate": 1654104600000,
  "operatingOnId": "12ab3c45de678910abc12345",
  "integrationMetadata": {
    "externalId": "string",
    "externalStatus": {
      "display": "string",
      "value": "string"
    },
    "externalUrl": "string",
    "lastChecked": 1
  },
  "source": {
    "key": "source-flag-key-123abc",
    "version": 1
  },
  "customWorkflowMetadata": {
    "name": "Example workflow name",
    "stage": {
      "index": 0,
      "name": "Stage 1"
    }
  },
  "resourceId": "string",
  "approvalSettings": {
    "required": true,
    "bypassApprovalsForPendingChanges": false,
    "minNumApprovals": 1,
    "canReviewOwnRequest": false,
    "canApplyDeclinedChanges": true,
    "serviceKind": "launchdarkly",
    "serviceConfig": {},
    "requiredApprovalTags": [
      "require-approval"
    ],
    "autoApplyApprovedChanges": true,
    "serviceKindConfigurationId": "1ef45a85-218f-4428-a8b2-a97e5f56c258"
  },
  "project": {
    "_links": {
      "environments": {
        "href": "/api/v2/projects/my-project/environments",
        "type": "application/json"
      },
      "self": {
        "href": "/api/v2/projects/my-project",
        "type": "application/json"
      }
    },
    "_id": "57be1db38b75bf0772d11383",
    "key": "project-key-123abc",
    "includeInSnippetByDefault": true,
    "name": "My Project",
    "tags": [
      "ops"
    ],
    "defaultClientSideAvailability": {
      "usingMobileKey": true,
      "usingEnvironmentId": true
    },
    "_access": {
      "denied": [
        {
          "action": "string",
          "reason": {
            "effect": "allow",
            "resources": [
              "proj/*:env/*;qa_*:/flag/*"
            ],
            "notResources": [
              "string"
            ],
            "actions": [
              "*"
            ],
            "notActions": [
              "string"
            ],
            "role_name": "string"
          }
        }
      ],
      "allowed": [
        {
          "action": "string",
          "reason": {
            "effect": "allow",
            "resources": [
              "proj/*:env/*;qa_*:/flag/*"
            ],
            "notResources": [
              "string"
            ],
            "actions": [
              "*"
            ],
            "notActions": [
              "string"
            ],
            "role_name": "string"
          }
        }
      ]
    },
    "defaultReleasePipelineKey": "string",
    "environments": {
      "items": [
        {
          "_links": {
            "self": {
              "href": "/api/v2/projects/my-project/environments/my-environment",
              "type": "application/json"
            }
          },
          "_id": "57be1db38b75bf0772d11384",
          "key": "environment-key-123abc",
          "name": "My Environment",
          "apiKey": "sdk-xxx",
          "mobileKey": "mob-xxx",
          "color": "F5A623",
          "defaultTtl": 5,
          "secureMode": true,
          "defaultTrackEvents": false,
          "requireComments": true,
          "confirmChanges": true,
          "tags": [
            "ops"
          ],
          "critical": true,
          "_access": {
            "denied": [
              {
                "action": "string",
                "reason": {
                  "effect": "allow",
                  "resources": [
                    "proj/*:env/*;qa_*:/flag/*"
                  ],
                  "notResources": [
                    "string"
                  ],
                  "actions": [
                    "*"
                  ],
                  "notActions": [
                    "string"
                  ],
                  "role_name": "string"
                }
              }
            ],
            "allowed": [
              {
                "action": "string",
                "reason": {
                  "effect": "allow",
                  "resources": [
                    "proj/*:env/*;qa_*:/flag/*"
                  ],
                  "notResources": [
                    "string"
                  ],
                  "actions": [
                    "*"
                  ],
                  "notActions": [
                    "string"
                  ],
                  "role_name": "string"
                }
              }
            ]
          },
          "approvalSettings": {
            "required": true,
            "bypassApprovalsForPendingChanges": false,
            "minNumApprovals": 1,
            "canReviewOwnRequest": false,
            "canApplyDeclinedChanges": true,
            "serviceKind": "launchdarkly",
            "serviceConfig": {},
            "requiredApprovalTags": [
              "require-approval"
            ],
            "autoApplyApprovedChanges": true,
            "serviceKindConfigurationId": "1ef45a85-218f-4428-a8b2-a97e5f56c258"
          },
          "resourceApprovalSettings": {}
        }
      ],
      "_links": {},
      "totalCount": 2
    }
  },
  "environments": [
    {
      "_links": {
        "self": {
          "href": "/api/v2/projects/my-project/environments/my-environment",
          "type": "application/json"
        }
      },
      "_id": "57be1db38b75bf0772d11384",
      "key": "environment-key-123abc",
      "name": "My Environment",
      "apiKey": "sdk-xxx",
      "mobileKey": "mob-xxx",
      "color": "F5A623",
      "defaultTtl": 5,
      "secureMode": true,
      "defaultTrackEvents": false,
      "requireComments": true,
      "confirmChanges": true,
      "tags": [
        "ops"
      ],
      "critical": true,
      "_access": {
        "denied": [
          {
            "action": "string",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "string"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string"
              ],
              "role_name": "string"
            }
          }
        ],
        "allowed": [
          {
            "action": "string",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "string"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string"
              ],
              "role_name": "string"
            }
          }
        ]
      },
      "approvalSettings": {
        "required": true,
        "bypassApprovalsForPendingChanges": false,
        "minNumApprovals": 1,
        "canReviewOwnRequest": false,
        "canApplyDeclinedChanges": true,
        "serviceKind": "launchdarkly",
        "serviceConfig": {},
        "requiredApprovalTags": [
          "require-approval"
        ],
        "autoApplyApprovedChanges": true,
        "serviceKindConfigurationId": "1ef45a85-218f-4428-a8b2-a97e5f56c258"
      },
      "resourceApprovalSettings": {}
    }
  ],
  "flag": {
    "name": "My Flag",
    "kind": "boolean",
    "key": "flag-key-123abc",
    "_version": 1,
    "creationDate": 1494437420312,
    "variations": [
      {
        "value": null,
        "_id": "e432f62b-55f6-49dd-a02f-eb24acf39d05"
      },
      {
        "value": null,
        "_id": "a00bf58d-d252-476c-b915-15a74becacb4"
      }
    ],
    "temporary": true,
    "tags": [
      "example-tag"
    ],
    "_links": {
      "parent": {
        "href": "/api/v2/flags/my-project",
        "type": "application/json"
      },
      "self": {
        "href": "/api/v2/flags/my-project/my-flag",
        "type": "application/json"
      }
    },
    "customProperties": "{\"jira.issues\":{\"name\":\"Jira issues\",\"value\":[\"is-123\",\"is-456\"]}}",
    "archived": false,
    "description": "This flag controls the example widgets",
    "clientSideAvailability": {},
    "maintainerId": "569f183514f4432160000007",
    "_maintainer": {
      "_links": {
        "self": {
          "href": "/api/v2/members/569f183514f4432160000007",
          "type": "application/json"
        }
      },
      "_id": "569f183514f4432160000007",
      "role": "admin",
      "email": "ariel@acme.com",
      "firstName": "Ariel",
      "lastName": "Flores"
    },
    "archivedDate": 1494437420312,
    "defaults": {
      "onVariation": 0,
      "offVariation": 1
    },
    "includeInSnippet": true
  },
  "resource": {
    "kind": "flag",
    "aiConfig": {
      "key": "aiconfig-key-123abc",
      "name": "AI Config 1"
    },
    "experiment": {
      "key": "experiment-key-123abc",
      "name": "My Experiment",
      "_access": {
        "denied": [
          {
            "action": "string",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "string"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string"
              ],
              "role_name": "string"
            }
          }
        ],
        "allowed": [
          {
            "action": "string",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "string"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string"
              ],
              "role_name": "string"
            }
          }
        ]
      }
    },
    "flag": {
      "name": "My Flag",
      "kind": "boolean",
      "key": "flag-key-123abc",
      "_version": 1,
      "creationDate": 1494437420312,
      "variations": [
        {
          "value": null,
          "_id": "e432f62b-55f6-49dd-a02f-eb24acf39d05"
        },
        {
          "value": null,
          "_id": "a00bf58d-d252-476c-b915-15a74becacb4"
        }
      ],
      "temporary": true,
      "tags": [
        "example-tag"
      ],
      "_links": {
        "parent": {
          "href": "/api/v2/flags/my-project",
          "type": "application/json"
        },
        "self": {
          "href": "/api/v2/flags/my-project/my-flag",
          "type": "application/json"
        }
      },
      "customProperties": "{\"jira.issues\":{\"name\":\"Jira issues\",\"value\":[\"is-123\",\"is-456\"]}}",
      "archived": false,
      "description": "This flag controls the example widgets",
      "clientSideAvailability": {},
      "maintainerId": "569f183514f4432160000007",
      "_maintainer": {
        "_links": {
          "self": {
            "href": "/api/v2/members/569f183514f4432160000007",
            "type": "application/json"
          }
        },
        "_id": "569f183514f4432160000007",
        "role": "admin",
        "email": "ariel@acme.com",
        "firstName": "Ariel",
        "lastName": "Flores"
      },
      "archivedDate": 1494437420312,
      "defaults": {
        "onVariation": 0,
        "offVariation": 1
      },
      "includeInSnippet": true
    },
    "segment": {
      "name": "Example segment",
      "tags": [
        "testing"
      ],
      "creationDate": 1654104600000,
      "lastModifiedDate": 1654104600000,
      "key": "segment-key-123abc",
      "_links": {},
      "rules": [
        {
          "clauses": [
            {
              "attribute": "email",
              "op": "endsWith",
              "values": [
                ".edu"
              ],
              "negate": false,
              "_id": "12ab3c45de678910fab12345"
            }
          ],
          "_id": "1234a56b7c89d012345e678f"
        }
      ],
      "version": 1,
      "deleted": false,
      "generation": 1,
      "description": "Bundle our sample customers together",
      "included": [
        "user-key-123abc"
      ],
      "excluded": [
        "user-key-123abc"
      ],
      "includedContexts": [
        {
          "values": [
            "string"
          ],
          "contextKind": "string"
        }
      ],
      "excludedContexts": [
        {
          "values": [
            "string"
          ],
          "contextKind": "string"
        }
      ],
      "_access": {
        "denied": [
          {
            "action": "string",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "string"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string"
              ],
              "role_name": "string"
            }
          }
        ],
        "allowed": [
          {
            "action": "string",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "string"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string"
              ],
              "role_name": "string"
            }
          }
        ]
      },
      "_flags": [
        {
          "name": "Example flag",
          "key": "flag-key-123abc",
          "_links": {},
          "_site": {
            "href": "string",
            "type": "string"
          }
        }
      ],
      "unbounded": false,
      "unboundedContextKind": "string",
      "_unboundedMetadata": {
        "envId": "string",
        "segmentId": "string",
        "version": 1,
        "includedCount": 1,
        "excludedCount": 1,
        "lastModified": 1,
        "deleted": true
      },
      "_external": "amplitude",
      "_externalLink": "https://analytics.amplitude.com/org/1234/cohort/123abc",
      "_importInProgress": false
    }
  }
}

Get approval request

Get approval request

Expanding approval response

Authentication

Path parameters

Query parameters

Response

Errors

Expanding approval response

Authentication

Path parameters

Query parameters

Response

Errors

$	curl https://app.launchdarkly.com/api/v2/approval-requests/id \
>	-H "Authorization: <apiKey>"

1	{
2	"_id": "12ab3c45de678910abc12345",
3	"_version": 1,
4	"creationDate": 1654104600000,
5	"serviceKind": "launchdarkly",
6	"reviewStatus": "pending",
7	"allReviews": [
8	{
9	"_id": "12ab3c45de678910abc12345",
10	"kind": "approve",
11	"creationDate": 1653606981113,
12	"comment": "Approved!",
13	"memberId": "12ab3c45de678910abc12345",
14	"serviceTokenId": "12ab3c45de678910abc12345"
15	}
16	],
17	"notifyMemberIds": [
18	"1234a56b7c89d012345e678f"
19	],
20	"status": "pending",
21	"instructions": [
22	"[{\"kind\": \"turnFlagOn\"}]"
23	],
24	"conflicts": [
25	{
26	"instruction": {},
27	"reason": "string"
28	}
29	],
30	"_links": {},
31	"requestorId": "12ab3c45de678910abc12345",
32	"description": "example: request approval from someone",
33	"appliedDate": 1654104600000,
34	"appliedByMemberId": "1234a56b7c89d012345e678f",
35	"appliedByServiceTokenId": "1234a56b7c89d012345e678f",
36	"executionDate": 1654104600000,
37	"operatingOnId": "12ab3c45de678910abc12345",
38	"integrationMetadata": {
39	"externalId": "string",
40	"externalStatus": {
41	"display": "string",
42	"value": "string"
43	},
44	"externalUrl": "string",
45	"lastChecked": 1
46	},
47	"source": {
48	"key": "source-flag-key-123abc",
49	"version": 1
50	},
51	"customWorkflowMetadata": {
52	"name": "Example workflow name",
53	"stage": {
54	"index": 0,
55	"name": "Stage 1"
56	}
57	},
58	"resourceId": "string",
59	"approvalSettings": {
60	"required": true,
61	"bypassApprovalsForPendingChanges": false,
62	"minNumApprovals": 1,
63	"canReviewOwnRequest": false,
64	"canApplyDeclinedChanges": true,
65	"serviceKind": "launchdarkly",
66	"serviceConfig": {},
67	"requiredApprovalTags": [
68	"require-approval"
69	],
70	"autoApplyApprovedChanges": true,
71	"serviceKindConfigurationId": "1ef45a85-218f-4428-a8b2-a97e5f56c258"
72	},
73	"project": {
74	"_links": {
75	"environments": {
76	"href": "/api/v2/projects/my-project/environments",
77	"type": "application/json"
78	},
79	"self": {
80	"href": "/api/v2/projects/my-project",
81	"type": "application/json"
82	}
83	},
84	"_id": "57be1db38b75bf0772d11383",
85	"key": "project-key-123abc",
86	"includeInSnippetByDefault": true,
87	"name": "My Project",
88	"tags": [
89	"ops"
90	],
91	"defaultClientSideAvailability": {
92	"usingMobileKey": true,
93	"usingEnvironmentId": true
94	},
95	"_access": {
96	"denied": [
97	{
98	"action": "string",
99	"reason": {
100	"effect": "allow",
101	"resources": [
102	"proj/:env/;qa_:/flag/"
103	],
104	"notResources": [
105	"string"
106	],
107	"actions": [
108	"*"
109	],
110	"notActions": [
111	"string"
112	],
113	"role_name": "string"
114	}
115	}
116	],
117	"allowed": [
118	{
119	"action": "string",
120	"reason": {
121	"effect": "allow",
122	"resources": [
123	"proj/:env/;qa_:/flag/"
124	],
125	"notResources": [
126	"string"
127	],
128	"actions": [
129	"*"
130	],
131	"notActions": [
132	"string"
133	],
134	"role_name": "string"
135	}
136	}
137	]
138	},
139	"defaultReleasePipelineKey": "string",
140	"environments": {
141	"items": [
142	{
143	"_links": {
144	"self": {
145	"href": "/api/v2/projects/my-project/environments/my-environment",
146	"type": "application/json"
147	}
148	},
149	"_id": "57be1db38b75bf0772d11384",
150	"key": "environment-key-123abc",
151	"name": "My Environment",
152	"apiKey": "sdk-xxx",
153	"mobileKey": "mob-xxx",
154	"color": "F5A623",
155	"defaultTtl": 5,
156	"secureMode": true,
157	"defaultTrackEvents": false,
158	"requireComments": true,
159	"confirmChanges": true,
160	"tags": [
161	"ops"
162	],
163	"critical": true,
164	"_access": {
165	"denied": [
166	{
167	"action": "string",
168	"reason": {
169	"effect": "allow",
170	"resources": [
171	"proj/:env/;qa_:/flag/"
172	],
173	"notResources": [
174	"string"
175	],
176	"actions": [
177	"*"
178	],
179	"notActions": [
180	"string"
181	],
182	"role_name": "string"
183	}
184	}
185	],
186	"allowed": [
187	{
188	"action": "string",
189	"reason": {
190	"effect": "allow",
191	"resources": [
192	"proj/:env/;qa_:/flag/"
193	],
194	"notResources": [
195	"string"
196	],
197	"actions": [
198	"*"
199	],
200	"notActions": [
201	"string"
202	],
203	"role_name": "string"
204	}
205	}
206	]
207	},
208	"approvalSettings": {
209	"required": true,
210	"bypassApprovalsForPendingChanges": false,
211	"minNumApprovals": 1,
212	"canReviewOwnRequest": false,
213	"canApplyDeclinedChanges": true,
214	"serviceKind": "launchdarkly",
215	"serviceConfig": {},
216	"requiredApprovalTags": [
217	"require-approval"
218	],
219	"autoApplyApprovedChanges": true,
220	"serviceKindConfigurationId": "1ef45a85-218f-4428-a8b2-a97e5f56c258"
221	},
222	"resourceApprovalSettings": {}
223	}
224	],
225	"_links": {},
226	"totalCount": 2
227	}
228	},
229	"environments": [
230	{
231	"_links": {
232	"self": {
233	"href": "/api/v2/projects/my-project/environments/my-environment",
234	"type": "application/json"
235	}
236	},
237	"_id": "57be1db38b75bf0772d11384",
238	"key": "environment-key-123abc",
239	"name": "My Environment",
240	"apiKey": "sdk-xxx",
241	"mobileKey": "mob-xxx",
242	"color": "F5A623",
243	"defaultTtl": 5,
244	"secureMode": true,
245	"defaultTrackEvents": false,
246	"requireComments": true,
247	"confirmChanges": true,
248	"tags": [
249	"ops"
250	],
251	"critical": true,
252	"_access": {
253	"denied": [
254	{
255	"action": "string",
256	"reason": {
257	"effect": "allow",
258	"resources": [
259	"proj/:env/;qa_:/flag/"
260	],
261	"notResources": [
262	"string"
263	],
264	"actions": [
265	"*"
266	],
267	"notActions": [
268	"string"
269	],
270	"role_name": "string"
271	}
272	}
273	],
274	"allowed": [
275	{
276	"action": "string",
277	"reason": {
278	"effect": "allow",
279	"resources": [
280	"proj/:env/;qa_:/flag/"
281	],
282	"notResources": [
283	"string"
284	],
285	"actions": [
286	"*"
287	],
288	"notActions": [
289	"string"
290	],
291	"role_name": "string"
292	}
293	}
294	]
295	},
296	"approvalSettings": {
297	"required": true,
298	"bypassApprovalsForPendingChanges": false,
299	"minNumApprovals": 1,
300	"canReviewOwnRequest": false,
301	"canApplyDeclinedChanges": true,
302	"serviceKind": "launchdarkly",
303	"serviceConfig": {},
304	"requiredApprovalTags": [
305	"require-approval"
306	],
307	"autoApplyApprovedChanges": true,
308	"serviceKindConfigurationId": "1ef45a85-218f-4428-a8b2-a97e5f56c258"
309	},
310	"resourceApprovalSettings": {}
311	}
312	],
313	"flag": {
314	"name": "My Flag",
315	"kind": "boolean",
316	"key": "flag-key-123abc",
317	"_version": 1,
318	"creationDate": 1494437420312,
319	"variations": [
320	{
321	"value": null,
322	"_id": "e432f62b-55f6-49dd-a02f-eb24acf39d05"
323	},
324	{
325	"value": null,
326	"_id": "a00bf58d-d252-476c-b915-15a74becacb4"
327	}
328	],
329	"temporary": true,
330	"tags": [
331	"example-tag"
332	],
333	"_links": {
334	"parent": {
335	"href": "/api/v2/flags/my-project",
336	"type": "application/json"
337	},
338	"self": {
339	"href": "/api/v2/flags/my-project/my-flag",
340	"type": "application/json"
341	}
342	},
343	"customProperties": "{\"jira.issues\":{\"name\":\"Jira issues\",\"value\":[\"is-123\",\"is-456\"]}}",
344	"archived": false,
345	"description": "This flag controls the example widgets",
346	"clientSideAvailability": {},
347	"maintainerId": "569f183514f4432160000007",
348	"_maintainer": {
349	"_links": {
350	"self": {
351	"href": "/api/v2/members/569f183514f4432160000007",
352	"type": "application/json"
353	}
354	},
355	"_id": "569f183514f4432160000007",
356	"role": "admin",
357	"email": "ariel@acme.com",
358	"firstName": "Ariel",
359	"lastName": "Flores"
360	},
361	"archivedDate": 1494437420312,
362	"defaults": {
363	"onVariation": 0,
364	"offVariation": 1
365	},
366	"includeInSnippet": true
367	},
368	"resource": {
369	"kind": "flag",
370	"aiConfig": {
371	"key": "aiconfig-key-123abc",
372	"name": "AI Config 1"
373	},
374	"experiment": {
375	"key": "experiment-key-123abc",
376	"name": "My Experiment",
377	"_access": {
378	"denied": [
379	{
380	"action": "string",
381	"reason": {
382	"effect": "allow",
383	"resources": [
384	"proj/:env/;qa_:/flag/"
385	],
386	"notResources": [
387	"string"
388	],
389	"actions": [
390	"*"
391	],
392	"notActions": [
393	"string"
394	],
395	"role_name": "string"
396	}
397	}
398	],
399	"allowed": [
400	{
401	"action": "string",
402	"reason": {
403	"effect": "allow",
404	"resources": [
405	"proj/:env/;qa_:/flag/"
406	],
407	"notResources": [
408	"string"
409	],
410	"actions": [
411	"*"
412	],
413	"notActions": [
414	"string"
415	],
416	"role_name": "string"
417	}
418	}
419	]
420	}
421	},
422	"flag": {
423	"name": "My Flag",
424	"kind": "boolean",
425	"key": "flag-key-123abc",
426	"_version": 1,
427	"creationDate": 1494437420312,
428	"variations": [
429	{
430	"value": null,
431	"_id": "e432f62b-55f6-49dd-a02f-eb24acf39d05"
432	},
433	{
434	"value": null,
435	"_id": "a00bf58d-d252-476c-b915-15a74becacb4"
436	}
437	],
438	"temporary": true,
439	"tags": [
440	"example-tag"
441	],
442	"_links": {
443	"parent": {
444	"href": "/api/v2/flags/my-project",
445	"type": "application/json"
446	},
447	"self": {
448	"href": "/api/v2/flags/my-project/my-flag",
449	"type": "application/json"
450	}
451	},
452	"customProperties": "{\"jira.issues\":{\"name\":\"Jira issues\",\"value\":[\"is-123\",\"is-456\"]}}",
453	"archived": false,
454	"description": "This flag controls the example widgets",
455	"clientSideAvailability": {},
456	"maintainerId": "569f183514f4432160000007",
457	"_maintainer": {
458	"_links": {
459	"self": {
460	"href": "/api/v2/members/569f183514f4432160000007",
461	"type": "application/json"
462	}
463	},
464	"_id": "569f183514f4432160000007",
465	"role": "admin",
466	"email": "ariel@acme.com",
467	"firstName": "Ariel",
468	"lastName": "Flores"
469	},
470	"archivedDate": 1494437420312,
471	"defaults": {
472	"onVariation": 0,
473	"offVariation": 1
474	},
475	"includeInSnippet": true
476	},
477	"segment": {
478	"name": "Example segment",
479	"tags": [
480	"testing"
481	],
482	"creationDate": 1654104600000,
483	"lastModifiedDate": 1654104600000,
484	"key": "segment-key-123abc",
485	"_links": {},
486	"rules": [
487	{
488	"clauses": [
489	{
490	"attribute": "email",
491	"op": "endsWith",
492	"values": [
493	".edu"
494	],
495	"negate": false,
496	"_id": "12ab3c45de678910fab12345"
497	}
498	],
499	"_id": "1234a56b7c89d012345e678f"
500	}
501	],
502	"version": 1,
503	"deleted": false,
504	"generation": 1,
505	"description": "Bundle our sample customers together",
506	"included": [
507	"user-key-123abc"
508	],
509	"excluded": [
510	"user-key-123abc"
511	],
512	"includedContexts": [
513	{
514	"values": [
515	"string"
516	],
517	"contextKind": "string"
518	}
519	],
520	"excludedContexts": [
521	{
522	"values": [
523	"string"
524	],
525	"contextKind": "string"
526	}
527	],
528	"_access": {
529	"denied": [
530	{
531	"action": "string",
532	"reason": {
533	"effect": "allow",
534	"resources": [
535	"proj/:env/;qa_:/flag/"
536	],
537	"notResources": [
538	"string"
539	],
540	"actions": [
541	"*"
542	],
543	"notActions": [
544	"string"
545	],
546	"role_name": "string"
547	}
548	}
549	],
550	"allowed": [
551	{
552	"action": "string",
553	"reason": {
554	"effect": "allow",
555	"resources": [
556	"proj/:env/;qa_:/flag/"
557	],
558	"notResources": [
559	"string"
560	],
561	"actions": [
562	"*"
563	],
564	"notActions": [
565	"string"
566	],
567	"role_name": "string"
568	}
569	}
570	]
571	},
572	"_flags": [
573	{
574	"name": "Example flag",
575	"key": "flag-key-123abc",
576	"_links": {},
577	"_site": {
578	"href": "string",
579	"type": "string"
580	}
581	}
582	],
583	"unbounded": false,
584	"unboundedContextKind": "string",
585	"_unboundedMetadata": {
586	"envId": "string",
587	"segmentId": "string",
588	"version": 1,
589	"includedCount": 1,
590	"excludedCount": 1,
591	"lastModified": 1,
592	"deleted": true
593	},
594	"_external": "amplitude",
595	"_externalLink": "https://analytics.amplitude.com/org/1234/cohort/123abc",
596	"_importInProgress": false
597	}
598	}
599	}