Sign in

v5

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-02-283466592.5 MB
AI Configs

Create new agent graph

Create a new agent graph within the given project.

post/api/v2/projects/{projectKey}/agent-graphs

Path parameters

projectKeystring required

Headers

LD-API-Version'beta' required

Version of the endpoint.

Request body

keystring required

A unique key for the agent graph

namestring required

A human-readable name for the agent graph

descriptionstring

A description of the agent graph

maintainerIdstring

The ID of the member who maintains this agent graph

maintainerTeamKeystring

The key of the team that maintains this agent graph

rootConfigKeystring

The AI Config key of the root node. A missing root implies a newly created graph with metadata only.

Example request

{
  "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",
  "key": "key"
}

Response

Agent graph created

keystring required

A unique key for the agent graph

namestring required

A human-readable name for the agent graph

descriptionstring

A description of the agent graph

rootConfigKeystring

The AI Config key of the root node

createdAtinteger required
updatedAtinteger required

Example response

{
  "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",
  "name": "name",
  "edges": [
    {
      "sourceConfig": "sourceConfig",
      "targetConfig": "targetConfig",
      "handoff": "{}",
      "key": "key"
    },
    {
      "sourceConfig": "sourceConfig",
      "targetConfig": "targetConfig",
      "handoff": "{}",
      "key": "key"
    }
  ],
  "description": "description",
  "key": "key",
  "updatedAt": 6
}