Update a flag import configuration

For the complete documentation index, see llms.txt. For the full documentation snapshot, see llms-full.txt.

Updating a flag import configuration uses a JSON patch representation of the desired changes. To learn more, read Updates.

To add an element to the import configuration fields that are arrays, set the path to the name of the field and then append /<array index>. Use /0 to add to the beginning of the array. Use /- to add to the end of the array.

You can update the config, tags, and name of the flag import configuration.

PATCH /api/v2/integration-capabilities/flag-import/{projectKey}/{integrationKey}/{integrationId}

Update a flag import configuration

cURL

curl --request PATCH \
  --url https://app.launchdarkly.com/api/v2/integration-capabilities/flag-import/{projectKey}/{integrationKey}/{integrationId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "op": "replace",
    "path": "/exampleField",
    "value": "new example value"
  }
]
'

200

{
  "_links": {
    "self": {
      "href": "<string>",
      "type": "<string>"
    },
    "parent": {
      "href": "<string>",
      "type": "<string>"
    },
    "project": {
      "href": "<string>",
      "type": "<string>"
    }
  },
  "_id": "12ab3c4d5ef1a2345bcde67f",
  "integrationKey": "split",
  "projectKey": "default",
  "config": {},
  "tags": [],
  "name": "Development environment configuration",
  "version": 1,
  "_status": {
    "status": "pending",
    "lastImport": "1717263000000",
    "lastError": "1714584600000",
    "errors": [
      {
        "integrationId": "<string>",
        "message": "<string>",
        "statusCode": 123,
        "timestamp": 123
      }
    ]
  },
  "_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>"
        }
      }
    ]
  }
}

Authorizations

Authorization · string · header · required

Path Parameters

projectKey · string<string> · required

The project key

integrationKey · string<string> · required

The integration key

integrationId · string<string> · required

The integration ID

Body

application/json

op · string · required

The type of operation to perform

Example:

"replace"

path · string · required

A JSON Pointer string specifying the part of the document to operate on

Example:

"/exampleField"

value · any

A JSON value used in "add", "replace", and "test" operations

Example:

"new example value"

Response

200

application/json

Flag import response

_links · object · required

The location and content type of related resources

Show child attributes

_id · string · required

The integration ID

Example:

"12ab3c4d5ef1a2345bcde67f"

integrationKey · enum<string> · required

The integration key

Available options: split, unleash

Example:

"split"

projectKey · string · required

The project key

Example:

"default"

config · object · required

The configuration for the given import integration. Only included when requesting a single integration by ID. Refer to the formVariables field in the corresponding manifest.json for a full list of fields for each integration.

Show child attributes

tags · string[] · required

List of tags for this configuration

Example:

[]

name · string · required

Name of the configuration

Example:

"Development environment configuration"

version · integer · required

Version of the current configuration

Example:

1

_status · object · required

Details on the status of the import job

Show child attributes

_access · object

Details on the allowed and denied actions for this configuration

Show child attributes