Update a flag import configuration | LaunchDarkly

curl -X PATCH https://app.launchdarkly.com/api/v2/integration-capabilities/flag-import/projectKey/integrationKey/integrationId \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '[
  {
    "op": "replace",
    "path": "/exampleField"
  }
]'

{
  "_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": 1,
        "timestamp": 1
      }
    ]
  },
  "_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"
        }
      }
    ]
  }
}

Updating a flag import configuration uses a [JSON patch](https://datatracker.ietf.org/doc/html/rfc6902) representation of the desired changes. To learn more, read [Updates](https://launchdarkly.com/docs/api#updates).<br/><br/>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.<br/><br/>You can update the `config`, `tags`, and `name` of the flag import configuration.

curl -X PATCH https://app.launchdarkly.com/api/v2/integration-capabilities/flag-import/projectKey/integrationKey/integrationId \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '[
  {
    "op": "replace",
    "path": "/exampleField"
  }
]'

{
  "_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": 1,
        "timestamp": 1
      }
    ]
  },
  "_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"
        }
      }
    ]
  }
}

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.

Authentication

Authorizationstring

API Key authentication via header

Path parameters

projectKeystringRequiredformat: "string"

The project key

integrationKeystringRequiredformat: "string"

The integration key

integrationIdstringRequiredformat: "string"

The integration ID

Request

This endpoint expects a list of objects.

opstringRequired

The type of operation to perform

pathstringRequired

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

valueanyOptional

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

Response

Flag import response

_linksobject

The location and content type of related resources

_idstring

The integration ID

integrationKeyenum

The integration key

Allowed values:

projectKeystring

The project key

configmap from strings to any

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.

tagslist of strings

List of tags for this configuration

namestring

Name of the configuration

versioninteger

Version of the current configuration

_statusobject

Details on the status of the import job

_accessobject

Details on the allowed and denied actions for this configuration

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

$	curl -X PATCH https://app.launchdarkly.com/api/v2/integration-capabilities/flag-import/projectKey/integrationKey/integrationId \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '[
>	{
>	"op": "replace",
>	"path": "/exampleField"
>	}
>	]'

1	{
2	"_links": {
3	"self": {
4	"href": "string",
5	"type": "string"
6	},
7	"parent": {
8	"href": "string",
9	"type": "string"
10	},
11	"project": {
12	"href": "string",
13	"type": "string"
14	}
15	},
16	"_id": "12ab3c4d5ef1a2345bcde67f",
17	"integrationKey": "split",
18	"projectKey": "default",
19	"config": {},
20	"tags": [],
21	"name": "Development environment configuration",
22	"version": 1,
23	"_status": {
24	"status": "pending",
25	"lastImport": 1717263000000,
26	"lastError": 1714584600000,
27	"errors": [
28	{
29	"integrationId": "string",
30	"message": "string",
31	"statusCode": 1,
32	"timestamp": 1
33	}
34	]
35	},
36	"_access": {
37	"denied": [
38	{
39	"action": "string",
40	"reason": {
41	"effect": "allow",
42	"resources": [
43	"proj/:env/;qa_:/flag/"
44	],
45	"notResources": [
46	"string"
47	],
48	"actions": [
49	"*"
50	],
51	"notActions": [
52	"string"
53	],
54	"role_name": "string"
55	}
56	}
57	],
58	"allowed": [
59	{
60	"action": "string",
61	"reason": {
62	"effect": "allow",
63	"resources": [
64	"proj/:env/;qa_:/flag/"
65	],
66	"notResources": [
67	"string"
68	],
69	"actions": [
70	"*"
71	],
72	"notActions": [
73	"string"
74	],
75	"role_name": "string"
76	}
77	}
78	]
79	}
80	}