Create approval request

curl --request POST \
  --url https://app.launchdarkly.com/api/v2/approval-requests \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "resourceId": "proj/projKey:env/envKey:flag/flagKey",
  "description": "Requesting to update targeting",
  "instructions": "[{\"kind\": \"addUserTargets\", \"values\": [ \"user-key-123abc\"], \"variationId\": \"ce67d625-a8b9-4fb5-a344-ab909d9d4f4d\" }]",
  "comment": "optional comment",
  "notifyMemberIds": [
    "1234a56b7c89d012345e678f"
  ],
  "notifyTeamKeys": [
    "example-reviewer-team"
  ],
  "integrationConfig": {}
}
'

import requests

url = "https://app.launchdarkly.com/api/v2/approval-requests"

payload = {
    "resourceId": "proj/projKey:env/envKey:flag/flagKey",
    "description": "Requesting to update targeting",
    "instructions": "[{\"kind\": \"addUserTargets\", \"values\": [ \"user-key-123abc\"], \"variationId\": \"ce67d625-a8b9-4fb5-a344-ab909d9d4f4d\" }]",
    "comment": "optional comment",
    "notifyMemberIds": ["1234a56b7c89d012345e678f"],
    "notifyTeamKeys": ["example-reviewer-team"],
    "integrationConfig": {}
}
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({
    resourceId: 'proj/projKey:env/envKey:flag/flagKey',
    description: 'Requesting to update targeting',
    instructions: '[{"kind": "addUserTargets", "values": [ "user-key-123abc"], "variationId": "ce67d625-a8b9-4fb5-a344-ab909d9d4f4d" }]',
    comment: 'optional comment',
    notifyMemberIds: ['1234a56b7c89d012345e678f'],
    notifyTeamKeys: ['example-reviewer-team'],
    integrationConfig: {}
  })
};

fetch('https://app.launchdarkly.com/api/v2/approval-requests', 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/approval-requests",
  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([
    'resourceId' => 'proj/projKey:env/envKey:flag/flagKey',
    'description' => 'Requesting to update targeting',
    'instructions' => '[{"kind": "addUserTargets", "values": [ "user-key-123abc"], "variationId": "ce67d625-a8b9-4fb5-a344-ab909d9d4f4d" }]',
    'comment' => 'optional comment',
    'notifyMemberIds' => [
        '1234a56b7c89d012345e678f'
    ],
    'notifyTeamKeys' => [
        'example-reviewer-team'
    ],
    'integrationConfig' => [
        
    ]
  ]),
  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/approval-requests"

	payload := strings.NewReader("{\n  \"resourceId\": \"proj/projKey:env/envKey:flag/flagKey\",\n  \"description\": \"Requesting to update targeting\",\n  \"instructions\": \"[{\\\"kind\\\": \\\"addUserTargets\\\", \\\"values\\\": [ \\\"user-key-123abc\\\"], \\\"variationId\\\": \\\"ce67d625-a8b9-4fb5-a344-ab909d9d4f4d\\\" }]\",\n  \"comment\": \"optional comment\",\n  \"notifyMemberIds\": [\n    \"1234a56b7c89d012345e678f\"\n  ],\n  \"notifyTeamKeys\": [\n    \"example-reviewer-team\"\n  ],\n  \"integrationConfig\": {}\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/approval-requests")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"resourceId\": \"proj/projKey:env/envKey:flag/flagKey\",\n  \"description\": \"Requesting to update targeting\",\n  \"instructions\": \"[{\\\"kind\\\": \\\"addUserTargets\\\", \\\"values\\\": [ \\\"user-key-123abc\\\"], \\\"variationId\\\": \\\"ce67d625-a8b9-4fb5-a344-ab909d9d4f4d\\\" }]\",\n  \"comment\": \"optional comment\",\n  \"notifyMemberIds\": [\n    \"1234a56b7c89d012345e678f\"\n  ],\n  \"notifyTeamKeys\": [\n    \"example-reviewer-team\"\n  ],\n  \"integrationConfig\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.launchdarkly.com/api/v2/approval-requests")

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  \"resourceId\": \"proj/projKey:env/envKey:flag/flagKey\",\n  \"description\": \"Requesting to update targeting\",\n  \"instructions\": \"[{\\\"kind\\\": \\\"addUserTargets\\\", \\\"values\\\": [ \\\"user-key-123abc\\\"], \\\"variationId\\\": \\\"ce67d625-a8b9-4fb5-a344-ab909d9d4f4d\\\" }]\",\n  \"comment\": \"optional comment\",\n  \"notifyMemberIds\": [\n    \"1234a56b7c89d012345e678f\"\n  ],\n  \"notifyTeamKeys\": [\n    \"example-reviewer-team\"\n  ],\n  \"integrationConfig\": {}\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"
    }
  },
  "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"
  }
}

{
  "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": "rate_limited",
  "message": "You've exceeded the API rate limit. Try again later."
}

Create approval request

Create an approval request.

This endpoint requires a list of instructions, in semantic patch format, that will be applied when the approval request is approved and applied.

Flags

If you are creating an approval request for a flag, you can use the following instructions:

addVariation
removeVariation
updateVariation
updateDefaultVariation

For details on using these instructions, read Update feature flag.

To create an approval for a flag specific to an environment, use Create approval request for a flag.

AgentControl

If you are creating an approval request for an AgentControl config, you can use the semantic patch instructions listed under Update config targeting.

Segments

If you are creating an approval request for a segment, you can use the semantic patch instructions listed under Patch segment.

POST

api

approval-requests

Create approval request

curl --request POST \
  --url https://app.launchdarkly.com/api/v2/approval-requests \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "resourceId": "proj/projKey:env/envKey:flag/flagKey",
  "description": "Requesting to update targeting",
  "instructions": "[{\"kind\": \"addUserTargets\", \"values\": [ \"user-key-123abc\"], \"variationId\": \"ce67d625-a8b9-4fb5-a344-ab909d9d4f4d\" }]",
  "comment": "optional comment",
  "notifyMemberIds": [
    "1234a56b7c89d012345e678f"
  ],
  "notifyTeamKeys": [
    "example-reviewer-team"
  ],
  "integrationConfig": {}
}
'

import requests

url = "https://app.launchdarkly.com/api/v2/approval-requests"

payload = {
    "resourceId": "proj/projKey:env/envKey:flag/flagKey",
    "description": "Requesting to update targeting",
    "instructions": "[{\"kind\": \"addUserTargets\", \"values\": [ \"user-key-123abc\"], \"variationId\": \"ce67d625-a8b9-4fb5-a344-ab909d9d4f4d\" }]",
    "comment": "optional comment",
    "notifyMemberIds": ["1234a56b7c89d012345e678f"],
    "notifyTeamKeys": ["example-reviewer-team"],
    "integrationConfig": {}
}
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({
    resourceId: 'proj/projKey:env/envKey:flag/flagKey',
    description: 'Requesting to update targeting',
    instructions: '[{"kind": "addUserTargets", "values": [ "user-key-123abc"], "variationId": "ce67d625-a8b9-4fb5-a344-ab909d9d4f4d" }]',
    comment: 'optional comment',
    notifyMemberIds: ['1234a56b7c89d012345e678f'],
    notifyTeamKeys: ['example-reviewer-team'],
    integrationConfig: {}
  })
};

fetch('https://app.launchdarkly.com/api/v2/approval-requests', 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/approval-requests",
  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([
    'resourceId' => 'proj/projKey:env/envKey:flag/flagKey',
    'description' => 'Requesting to update targeting',
    'instructions' => '[{"kind": "addUserTargets", "values": [ "user-key-123abc"], "variationId": "ce67d625-a8b9-4fb5-a344-ab909d9d4f4d" }]',
    'comment' => 'optional comment',
    'notifyMemberIds' => [
        '1234a56b7c89d012345e678f'
    ],
    'notifyTeamKeys' => [
        'example-reviewer-team'
    ],
    'integrationConfig' => [
        
    ]
  ]),
  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/approval-requests"

	payload := strings.NewReader("{\n  \"resourceId\": \"proj/projKey:env/envKey:flag/flagKey\",\n  \"description\": \"Requesting to update targeting\",\n  \"instructions\": \"[{\\\"kind\\\": \\\"addUserTargets\\\", \\\"values\\\": [ \\\"user-key-123abc\\\"], \\\"variationId\\\": \\\"ce67d625-a8b9-4fb5-a344-ab909d9d4f4d\\\" }]\",\n  \"comment\": \"optional comment\",\n  \"notifyMemberIds\": [\n    \"1234a56b7c89d012345e678f\"\n  ],\n  \"notifyTeamKeys\": [\n    \"example-reviewer-team\"\n  ],\n  \"integrationConfig\": {}\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/approval-requests")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"resourceId\": \"proj/projKey:env/envKey:flag/flagKey\",\n  \"description\": \"Requesting to update targeting\",\n  \"instructions\": \"[{\\\"kind\\\": \\\"addUserTargets\\\", \\\"values\\\": [ \\\"user-key-123abc\\\"], \\\"variationId\\\": \\\"ce67d625-a8b9-4fb5-a344-ab909d9d4f4d\\\" }]\",\n  \"comment\": \"optional comment\",\n  \"notifyMemberIds\": [\n    \"1234a56b7c89d012345e678f\"\n  ],\n  \"notifyTeamKeys\": [\n    \"example-reviewer-team\"\n  ],\n  \"integrationConfig\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.launchdarkly.com/api/v2/approval-requests")

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  \"resourceId\": \"proj/projKey:env/envKey:flag/flagKey\",\n  \"description\": \"Requesting to update targeting\",\n  \"instructions\": \"[{\\\"kind\\\": \\\"addUserTargets\\\", \\\"values\\\": [ \\\"user-key-123abc\\\"], \\\"variationId\\\": \\\"ce67d625-a8b9-4fb5-a344-ab909d9d4f4d\\\" }]\",\n  \"comment\": \"optional comment\",\n  \"notifyMemberIds\": [\n    \"1234a56b7c89d012345e678f\"\n  ],\n  \"notifyTeamKeys\": [\n    \"example-reviewer-team\"\n  ],\n  \"integrationConfig\": {}\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"
    }
  },
  "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"
  }
}

{
  "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": "rate_limited",
  "message": "You've exceeded the API rate limit. Try again later."
}

Authorizations

Authorization

string

header

required

Scopes

read

write

Body

application/json

resourceId

string

required

String representation of the resource specifier

Example:

"proj/projKey:env/envKey:flag/flagKey"

description

string

required

A brief description of the changes you're requesting

Example:

"Requesting to update targeting"

instructions

object[]

required

List of instructions in semantic patch format to be applied to the feature flag. Review the Update feature flag documentation for details on available instructions.

Show child attributes

Example:

"[{\"kind\": \"addUserTargets\", \"values\": [ \"user-key-123abc\"], \"variationId\": \"ce67d625-a8b9-4fb5-a344-ab909d9d4f4d\" }]"

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"]

integrationConfig

object

Additional approval request fields for third-party integration approval systems. If you are using a third-party integration to manage approval requests, these additional fields will be described in the manifest.json for that integration, at https://github.com/launchdarkly/integration-framework.

Show child attributes

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

resourceId

string

String representation of a resource

approvalSettings

object

The settings for this approval

Show child attributes