Update agent graph

curl -X PATCH https://app.launchdarkly.com/api/v2/projects/projectKey/agent-graphs/graphKey \
     -H "LD-API-Version: beta" \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "name",
  "description": "description",
  "maintainerId": "507f1f77bcf86cd799439011",
  "maintainerTeamKey": "example-team-key",
  "rootConfigKey": "rootConfigKey",
  "edges": [
    {
      "key": "key",
      "sourceConfig": "sourceConfig",
      "targetConfig": "targetConfig",
      "handoff": "{}"
    },
    {
      "key": "key",
      "sourceConfig": "sourceConfig",
      "targetConfig": "targetConfig",
      "handoff": "{}"
    }
  ]
}'

{
  "key": "key",
  "name": "name",
  "createdAt": 0,
  "updatedAt": 6,
  "_access": {
    "denied": [
      {
        "action": "action",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string",
            "string"
          ],
          "role_name": "role_name"
        }
      },
      {
        "action": "action",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string",
            "string"
          ],
          "role_name": "role_name"
        }
      }
    ],
    "allowed": [
      {
        "action": "action",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string",
            "string"
          ],
          "role_name": "role_name"
        }
      },
      {
        "action": "action",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string",
            "string"
          ],
          "role_name": "role_name"
        }
      }
    ]
  },
  "description": "description",
  "_maintainer": {
    "_id": "string",
    "email": "string",
    "role": "string",
    "kind": "kind"
  },
  "rootConfigKey": "rootConfigKey",
  "edges": [
    {
      "key": "key",
      "sourceConfig": "sourceConfig",
      "targetConfig": "targetConfig",
      "handoff": "{}"
    },
    {
      "key": "key",
      "sourceConfig": "sourceConfig",
      "targetConfig": "targetConfig",
      "handoff": "{}"
    }
  ]
}

Edit an existing agent graph.

The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields.

If the update includes rootConfigKey or edges, both must be present and will be treated as full replacements.

curl -X PATCH https://app.launchdarkly.com/api/v2/projects/projectKey/agent-graphs/graphKey \
     -H "LD-API-Version: beta" \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "name",
  "description": "description",
  "maintainerId": "507f1f77bcf86cd799439011",
  "maintainerTeamKey": "example-team-key",
  "rootConfigKey": "rootConfigKey",
  "edges": [
    {
      "key": "key",
      "sourceConfig": "sourceConfig",
      "targetConfig": "targetConfig",
      "handoff": "{}"
    },
    {
      "key": "key",
      "sourceConfig": "sourceConfig",
      "targetConfig": "targetConfig",
      "handoff": "{}"
    }
  ]
}'

{
  "key": "key",
  "name": "name",
  "createdAt": 0,
  "updatedAt": 6,
  "_access": {
    "denied": [
      {
        "action": "action",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string",
            "string"
          ],
          "role_name": "role_name"
        }
      },
      {
        "action": "action",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string",
            "string"
          ],
          "role_name": "role_name"
        }
      }
    ],
    "allowed": [
      {
        "action": "action",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string",
            "string"
          ],
          "role_name": "role_name"
        }
      },
      {
        "action": "action",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string",
            "string"
          ],
          "role_name": "role_name"
        }
      }
    ]
  },
  "description": "description",
  "_maintainer": {
    "_id": "string",
    "email": "string",
    "role": "string",
    "kind": "kind"
  },
  "rootConfigKey": "rootConfigKey",
  "edges": [
    {
      "key": "key",
      "sourceConfig": "sourceConfig",
      "targetConfig": "targetConfig",
      "handoff": "{}"
    },
    {
      "key": "key",
      "sourceConfig": "sourceConfig",
      "targetConfig": "targetConfig",
      "handoff": "{}"
    }
  ]
}

Edit an existing agent graph.

The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields.

If the update includes rootConfigKey or edges, both must be present and will be treated as full replacements.

Authentication

Authorizationstring

API Key authentication via header

Path parameters

projectKeystringRequired

graphKeystringRequired

Request

Agent graph object to update

namestringOptional

A human-readable name for the agent graph

descriptionstringOptional

A description of the agent graph

maintainerIdstringOptional

The ID of the member who maintains this agent graph. Pass an empty string to remove maintainer.

maintainerTeamKeystringOptional

The key of the team that maintains this agent graph. Pass an empty string to remove maintainer.

rootConfigKeystringOptional

The AI Config key of the root node. If present, edges must also be present.

edgeslist of objectsOptional

The edges in the graph. If present, rootConfigKey must also be present. Replaces all existing edges.

Response

Agent graph updated

keystring

A unique key for the agent graph

namestring

A human-readable name for the agent graph

createdAtlong

updatedAtlong

_accessobject

descriptionstring

A description of the agent graph

_maintainerobject

rootConfigKeystring

The AI Config key of the root node

edgeslist of objects

The edges in the graph

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

Update agent graph

Authentication

Path parameters

Headers

Request

Response

Errors

Authentication

Path parameters

Headers

Request

Response

Errors

$	curl -X PATCH https://app.launchdarkly.com/api/v2/projects/projectKey/agent-graphs/graphKey \
>	-H "LD-API-Version: beta" \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "name",
>	"description": "description",
>	"maintainerId": "507f1f77bcf86cd799439011",
>	"maintainerTeamKey": "example-team-key",
>	"rootConfigKey": "rootConfigKey",
>	"edges": [
>	{
>	"key": "key",
>	"sourceConfig": "sourceConfig",
>	"targetConfig": "targetConfig",
>	"handoff": "{}"
>	},
>	{
>	"key": "key",
>	"sourceConfig": "sourceConfig",
>	"targetConfig": "targetConfig",
>	"handoff": "{}"
>	}
>	]
>	}'

1	{
2	"key": "key",
3	"name": "name",
4	"createdAt": 0,
5	"updatedAt": 6,
6	"_access": {
7	"denied": [
8	{
9	"action": "action",
10	"reason": {
11	"effect": "allow",
12	"resources": [
13	"proj/:env/;qa_:/flag/"
14	],
15	"notResources": [
16	"notResources",
17	"notResources"
18	],
19	"actions": [
20	"*"
21	],
22	"notActions": [
23	"string",
24	"string"
25	],
26	"role_name": "role_name"
27	}
28	},
29	{
30	"action": "action",
31	"reason": {
32	"effect": "allow",
33	"resources": [
34	"proj/:env/;qa_:/flag/"
35	],
36	"notResources": [
37	"notResources",
38	"notResources"
39	],
40	"actions": [
41	"*"
42	],
43	"notActions": [
44	"string",
45	"string"
46	],
47	"role_name": "role_name"
48	}
49	}
50	],
51	"allowed": [
52	{
53	"action": "action",
54	"reason": {
55	"effect": "allow",
56	"resources": [
57	"proj/:env/;qa_:/flag/"
58	],
59	"notResources": [
60	"notResources",
61	"notResources"
62	],
63	"actions": [
64	"*"
65	],
66	"notActions": [
67	"string",
68	"string"
69	],
70	"role_name": "role_name"
71	}
72	},
73	{
74	"action": "action",
75	"reason": {
76	"effect": "allow",
77	"resources": [
78	"proj/:env/;qa_:/flag/"
79	],
80	"notResources": [
81	"notResources",
82	"notResources"
83	],
84	"actions": [
85	"*"
86	],
87	"notActions": [
88	"string",
89	"string"
90	],
91	"role_name": "role_name"
92	}
93	}
94	]
95	},
96	"description": "description",
97	"_maintainer": {
98	"_id": "string",
99	"email": "string",
100	"role": "string",
101	"kind": "kind"
102	},
103	"rootConfigKey": "rootConfigKey",
104	"edges": [
105	{
106	"key": "key",
107	"sourceConfig": "sourceConfig",
108	"targetConfig": "targetConfig",
109	"handoff": "{}"
110	},
111	{
112	"key": "key",
113	"sourceConfig": "sourceConfig",
114	"targetConfig": "targetConfig",
115	"handoff": "{}"
116	}
117	]
118	}