Agent Control

Update agent graph

PATCH
/api/v2/projects/{projectKey}/agent-graphs/{graphKey}

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.

Authorization

ApiKey read, write
Authorization<token>

In: header

Scope: read, write

Path Parameters

projectKey*string
graphKey*string

Header Parameters

LD-API-Version*"beta"

Version of the endpoint.

Value in

  • "beta"

Request Body

application/json

Agent graph object to update

Request body for updating an agent graph. If rootConfigKey or edges are present, both must be present.

name?string

A human-readable name for the agent graph

description?string

A description of the agent graph

maintainerId?string

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

maintainerTeamKey?string

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

rootConfigKey?string

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

edges?array<>

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

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/api/v2/projects/string/agent-graphs/string" \  -H "LD-API-Version: beta" \  -H "Content-Type: application/json" \  -d '{    "maintainerId": "507f1f77bcf86cd799439011",    "rootConfigKey": "rootConfigKey",    "name": "name",    "maintainerTeamKey": "example-team-key",    "edges": [      {        "sourceConfig": "sourceConfig",        "targetConfig": "targetConfig",        "handoff": "{}",        "key": "key"      },      {        "sourceConfig": "sourceConfig",        "targetConfig": "targetConfig",        "handoff": "{}",        "key": "key"      }    ],    "description": "description"  }'
{  "createdAt": 0,  "_maintainer": {    "kind": "kind"  },  "_access": {    "allowed": [      {        "reason": {          "role_name": "role_name",          "notActions": [            null,            null          ],          "notResources": [            "notResources",            "notResources"          ],          "effect": "allow",          "resources": [            "proj/*:env/*;qa_*:/flag/*"          ],          "actions": [            "*"          ]        },        "action": "action"      },      {        "reason": {          "role_name": "role_name",          "notActions": [            null,            null          ],          "notResources": [            "notResources",            "notResources"          ],          "effect": "allow",          "resources": [            "proj/*:env/*;qa_*:/flag/*"          ],          "actions": [            "*"          ]        },        "action": "action"      }    ],    "denied": [      {        "reason": {          "role_name": "role_name",          "notActions": [            null,            null          ],          "notResources": [            "notResources",            "notResources"          ],          "effect": "allow",          "resources": [            "proj/*:env/*;qa_*:/flag/*"          ],          "actions": [            "*"          ]        },        "action": "action"      },      {        "reason": {          "role_name": "role_name",          "notActions": [            null,            null          ],          "notResources": [            "notResources",            "notResources"          ],          "effect": "allow",          "resources": [            "proj/*:env/*;qa_*:/flag/*"          ],          "actions": [            "*"          ]        },        "action": "action"      }    ]  },  "rootConfigKey": "rootConfigKey",  "_site": {    "href": "href",    "type": "type"  },  "name": "name",  "edges": [    {      "sourceConfig": "sourceConfig",      "targetConfig": "targetConfig",      "handoff": "{}",      "key": "key"    },    {      "sourceConfig": "sourceConfig",      "targetConfig": "targetConfig",      "handoff": "{}",      "key": "key"    }  ],  "description": "description",  "key": "key",  "updatedAt": 6}