Create approval request to copy flag configurations across environments

curl --request POST \
  --url https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "copy flag settings to another environment",
  "source": {
    "key": "environment-key-123abc",
    "version": 1
  },
  "comment": "optional comment",
  "notifyMemberIds": [
    "1234a56b7c89d012345e678f"
  ],
  "notifyTeamKeys": [
    "example-reviewer-team"
  ],
  "includedActions": [
    "updateOn"
  ],
  "excludedActions": [
    "updateOn"
  ]
}
'

import requests

url = "https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy"

payload = {
    "description": "copy flag settings to another environment",
    "source": {
        "key": "environment-key-123abc",
        "version": 1
    },
    "comment": "optional comment",
    "notifyMemberIds": ["1234a56b7c89d012345e678f"],
    "notifyTeamKeys": ["example-reviewer-team"],
    "includedActions": ["updateOn"],
    "excludedActions": ["updateOn"]
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    description: 'copy flag settings to another environment',
    source: {key: 'environment-key-123abc', version: 1},
    comment: 'optional comment',
    notifyMemberIds: ['1234a56b7c89d012345e678f'],
    notifyTeamKeys: ['example-reviewer-team'],
    includedActions: ['updateOn'],
    excludedActions: ['updateOn']
  })
};

fetch('https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'description' => 'copy flag settings to another environment',
    'source' => [
        'key' => 'environment-key-123abc',
        'version' => 1
    ],
    'comment' => 'optional comment',
    'notifyMemberIds' => [
        '1234a56b7c89d012345e678f'
    ],
    'notifyTeamKeys' => [
        'example-reviewer-team'
    ],
    'includedActions' => [
        'updateOn'
    ],
    'excludedActions' => [
        'updateOn'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy"

	payload := strings.NewReader("{\n  \"description\": \"copy flag settings to another environment\",\n  \"source\": {\n    \"key\": \"environment-key-123abc\",\n    \"version\": 1\n  },\n  \"comment\": \"optional comment\",\n  \"notifyMemberIds\": [\n    \"1234a56b7c89d012345e678f\"\n  ],\n  \"notifyTeamKeys\": [\n    \"example-reviewer-team\"\n  ],\n  \"includedActions\": [\n    \"updateOn\"\n  ],\n  \"excludedActions\": [\n    \"updateOn\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"description\": \"copy flag settings to another environment\",\n  \"source\": {\n    \"key\": \"environment-key-123abc\",\n    \"version\": 1\n  },\n  \"comment\": \"optional comment\",\n  \"notifyMemberIds\": [\n    \"1234a56b7c89d012345e678f\"\n  ],\n  \"notifyTeamKeys\": [\n    \"example-reviewer-team\"\n  ],\n  \"includedActions\": [\n    \"updateOn\"\n  ],\n  \"excludedActions\": [\n    \"updateOn\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"description\": \"copy flag settings to another environment\",\n  \"source\": {\n    \"key\": \"environment-key-123abc\",\n    \"version\": 1\n  },\n  \"comment\": \"optional comment\",\n  \"notifyMemberIds\": [\n    \"1234a56b7c89d012345e678f\"\n  ],\n  \"notifyTeamKeys\": [\n    \"example-reviewer-team\"\n  ],\n  \"includedActions\": [\n    \"updateOn\"\n  ],\n  \"excludedActions\": [\n    \"updateOn\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "_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",
  "notifyTeamKeys": [
    "example-reviewer-team"
  ],
  "appliedDate": "1654104600000",
  "appliedByMemberId": "1234a56b7c89d012345e678f",
  "appliedByServiceTokenId": "1234a56b7c89d012345e678f",
  "executionDate": "1654104600000",
  "operatingOnId": "12ab3c45de678910abc12345",
  "integrationMetadata": {
    "externalId": "<string>",
    "externalStatus": {
      "display": "<string>",
      "value": "<string>"
    },
    "externalUrl": "<string>",
    "lastChecked": 123
  },
  "source": {
    "key": "source-flag-key-123abc",
    "version": 1
  },
  "customWorkflowMetadata": {
    "name": "Example workflow name",
    "stage": {
      "index": 0,
      "name": "Stage 1"
    }
  }
}

{
  "code": "invalid_request",
  "message": "Invalid request body"
}

{
  "code": "unauthorized",
  "message": "Invalid access token"
}

{
  "code": "forbidden",
  "message": "Forbidden. Access to the requested resource was denied."
}

{
  "code": "optimistic_locking_error",
  "message": "Conflict. Optimistic lock error. Try again later."
}

{
  "code": "rate_limited",
  "message": "You've exceeded the API rate limit. Try again later."
}

POST

api

projects

{projectKey}

flags

{featureFlagKey}

environments

{environmentKey}

approval-requests-flag-copy

Create approval request to copy flag configurations across environments

curl --request POST \
  --url https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "copy flag settings to another environment",
  "source": {
    "key": "environment-key-123abc",
    "version": 1
  },
  "comment": "optional comment",
  "notifyMemberIds": [
    "1234a56b7c89d012345e678f"
  ],
  "notifyTeamKeys": [
    "example-reviewer-team"
  ],
  "includedActions": [
    "updateOn"
  ],
  "excludedActions": [
    "updateOn"
  ]
}
'

import requests

url = "https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy"

payload = {
    "description": "copy flag settings to another environment",
    "source": {
        "key": "environment-key-123abc",
        "version": 1
    },
    "comment": "optional comment",
    "notifyMemberIds": ["1234a56b7c89d012345e678f"],
    "notifyTeamKeys": ["example-reviewer-team"],
    "includedActions": ["updateOn"],
    "excludedActions": ["updateOn"]
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    description: 'copy flag settings to another environment',
    source: {key: 'environment-key-123abc', version: 1},
    comment: 'optional comment',
    notifyMemberIds: ['1234a56b7c89d012345e678f'],
    notifyTeamKeys: ['example-reviewer-team'],
    includedActions: ['updateOn'],
    excludedActions: ['updateOn']
  })
};

fetch('https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'description' => 'copy flag settings to another environment',
    'source' => [
        'key' => 'environment-key-123abc',
        'version' => 1
    ],
    'comment' => 'optional comment',
    'notifyMemberIds' => [
        '1234a56b7c89d012345e678f'
    ],
    'notifyTeamKeys' => [
        'example-reviewer-team'
    ],
    'includedActions' => [
        'updateOn'
    ],
    'excludedActions' => [
        'updateOn'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy"

	payload := strings.NewReader("{\n  \"description\": \"copy flag settings to another environment\",\n  \"source\": {\n    \"key\": \"environment-key-123abc\",\n    \"version\": 1\n  },\n  \"comment\": \"optional comment\",\n  \"notifyMemberIds\": [\n    \"1234a56b7c89d012345e678f\"\n  ],\n  \"notifyTeamKeys\": [\n    \"example-reviewer-team\"\n  ],\n  \"includedActions\": [\n    \"updateOn\"\n  ],\n  \"excludedActions\": [\n    \"updateOn\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"description\": \"copy flag settings to another environment\",\n  \"source\": {\n    \"key\": \"environment-key-123abc\",\n    \"version\": 1\n  },\n  \"comment\": \"optional comment\",\n  \"notifyMemberIds\": [\n    \"1234a56b7c89d012345e678f\"\n  ],\n  \"notifyTeamKeys\": [\n    \"example-reviewer-team\"\n  ],\n  \"includedActions\": [\n    \"updateOn\"\n  ],\n  \"excludedActions\": [\n    \"updateOn\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"description\": \"copy flag settings to another environment\",\n  \"source\": {\n    \"key\": \"environment-key-123abc\",\n    \"version\": 1\n  },\n  \"comment\": \"optional comment\",\n  \"notifyMemberIds\": [\n    \"1234a56b7c89d012345e678f\"\n  ],\n  \"notifyTeamKeys\": [\n    \"example-reviewer-team\"\n  ],\n  \"includedActions\": [\n    \"updateOn\"\n  ],\n  \"excludedActions\": [\n    \"updateOn\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "_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",
  "notifyTeamKeys": [
    "example-reviewer-team"
  ],
  "appliedDate": "1654104600000",
  "appliedByMemberId": "1234a56b7c89d012345e678f",
  "appliedByServiceTokenId": "1234a56b7c89d012345e678f",
  "executionDate": "1654104600000",
  "operatingOnId": "12ab3c45de678910abc12345",
  "integrationMetadata": {
    "externalId": "<string>",
    "externalStatus": {
      "display": "<string>",
      "value": "<string>"
    },
    "externalUrl": "<string>",
    "lastChecked": 123
  },
  "source": {
    "key": "source-flag-key-123abc",
    "version": 1
  },
  "customWorkflowMetadata": {
    "name": "Example workflow name",
    "stage": {
      "index": 0,
      "name": "Stage 1"
    }
  }
}

{
  "code": "invalid_request",
  "message": "Invalid request body"
}

{
  "code": "unauthorized",
  "message": "Invalid access token"
}

{
  "code": "forbidden",
  "message": "Forbidden. Access to the requested resource was denied."
}

{
  "code": "optimistic_locking_error",
  "message": "Conflict. Optimistic lock error. Try again later."
}

{
  "code": "rate_limited",
  "message": "You've exceeded the API rate limit. Try again later."
}

Authorizations

Authorization

string

header

required

Scopes

read

write

Path Parameters

projectKey

string<string>

required

The project key

featureFlagKey

string<string>

required

The feature flag key

environmentKey

string<string>

required

The environment key for the target environment

Body

application/json

description

string

required

A brief description of your changes

Example:

"copy flag settings to another environment"

source

object

required

The flag to copy

Show child attributes

comment

string

Optional comment describing the approval request

Example:

"optional comment"

notifyMemberIds

string[]

An array of member IDs. These members are notified to review the approval request.

Example:

["1234a56b7c89d012345e678f"]

notifyTeamKeys

string[]

An array of team keys. The members of these teams are notified to review the approval request.

Example:

["example-reviewer-team"]

includedActions

enum<string>[]

Optional list of the flag changes to copy from the source environment to the target environment. You may include either includedActions or excludedActions, but not both. If neither are included, then all flag changes will be copied.

Available options:

updateOn,

updateFallthrough,

updateOffVariation,

updateRules,

updateTargets,

updatePrerequisites

Example:

["updateOn"]

excludedActions

enum<string>[]

Optional list of the flag changes NOT to copy from the source environment to the target environment. You may include either includedActions or excludedActions, but not both. If neither are included, then all flag changes will be copied.

Available options:

updateOn,

updateFallthrough,

updateOffVariation,

updateRules,

updateTargets,

updatePrerequisites

Example:

["updateOn"]

Response

Approval request response

_id

string

required

The ID of this approval request

Example:

"12ab3c45de678910abc12345"

_version

integer

required

Version of the approval request

Example:

1

creationDate

integer<int64>

required

Timestamp of when the approval request was created

Example:

"1654104600000"

serviceKind

string

required

The approval service for this request. May be LaunchDarkly or an external approval service, such as ServiceNow or JIRA.

Example:

"launchdarkly"

reviewStatus

enum<string>

required

Current status of the review of this approval request

Available options:

approved,

declined,

pending

Example:

"pending"

allReviews

object[]

required

An array of individual reviews of this approval request

Show child attributes

notifyMemberIds

string[]

required

An array of member IDs. These members are notified to review the approval request.

Example:

["1234a56b7c89d012345e678f"]

status

enum<string>

required

Current status of the approval request

Available options:

pending,

completed,

failed,

scheduled

Example:

"pending"

instructions

object[]

required

List of instructions in semantic patch format to be applied to the feature flag

Show child attributes

Example:

"[{\"kind\": \"turnFlagOn\"}]"

conflicts

object[]

required

Details on any conflicting approval requests

Show child attributes

_links

object

required

The location and content type of related resources

Show child attributes

requestorId

string

The ID of the member who requested the approval

Example:

"12ab3c45de678910abc12345"

description

string

A human-friendly name for the approval request

Example:

"example: request approval from someone"

notifyTeamKeys

string[]

An array of team keys, if teams were specified when the approval request was created. The members of these teams are listed in notifyMemberIds, resolved when the request was made. Team membership may have changed since then.

Example:

["example-reviewer-team"]

appliedDate

integer<int64>

Timestamp of when the approval request was applied

Example:

"1654104600000"

appliedByMemberId

string

The member ID of the member who applied the approval request

Example:

"1234a56b7c89d012345e678f"

appliedByServiceTokenId

string

The service token ID of the service token which applied the approval request

Example:

"1234a56b7c89d012345e678f"

executionDate

integer<int64>

Timestamp for when instructions will be executed

Example:

"1654104600000"

operatingOnId

string

ID of scheduled change to edit or delete

Example:

"12ab3c45de678910abc12345"

integrationMetadata

object

Details about the object in an external service corresponding to this approval request, such as a ServiceNow change request or a JIRA ticket, if an external approval service is being used

Show child attributes

source

object

Details about the source feature flag, if copied

Show child attributes

customWorkflowMetadata

object

Details about the custom workflow, if this approval request is part of a custom workflow

Show child attributes