{ "agentId": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "agentName": "My AI Agent", "activeGraphId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "draftGraphId": "b2c3d4e5-f6a7-8901-bcde-f12345678901"}
Agent Graph
Create a complete agent graph
Creates a new agent with its complete graph structure including nodes, edges, and tool configurations. Both an active/published graph and a draft graph are created.
{ "agentId": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "agentName": "My AI Agent", "activeGraphId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "draftGraphId": "b2c3d4e5-f6a7-8901-bcde-f12345678901"}
Authorizations
x-api-key
string
header
required
Headers
current-workspace-id
string
required
Body
application/json
agentName
string
required
The name of the agent to be created. This will be displayed in the UI and used to identify the agent
Example:
"Bitcoin Price Agent"
nodes
object[]
required
The complete list of nodes that make up the agent workflow graph. Nodes are connected by edges to form the execution flow. Must include at least one entry node (isEntryNode: true). Each node can have a tool configuration and is connected to other nodes via edges
Show child attributes
agentDescription
string
A detailed description of what the agent does and its capabilities
Example:
"An AI agent that fetches real-time cryptocurrency prices and provides market insights"
settings
object
Configuration settings for the agent including personality, restrictions, and suggested prompts
Show child attributes
Response
Agent and graph created successfully
agentId
string<uuid>
required
UUID of the created agent
Example:
"f47ac10b-58cc-4372-a567-0e02b2c3d479"
agentName
string
required
Name of the created agent
Example:
"My AI Agent"
activeGraphId
string<uuid>
required
UUID of the active/published graph
Example:
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
draftGraphId
string<uuid>
required
UUID of the draft graph
Example:
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Beam Academy","colors":{"primary":"#0066FF","light":"#4D94FF","dark":"#0052CC"},"logo":{"light":"https://mintcdn.com/beamai/x24-0VIErdtCXs3L/logo/light.svg?fit=max\u0026auto=format\u0026n=x24-0VIErdtCXs3L\u0026q=85\u0026s=7e65c5198f77ddd8b74f371dccb787f0","dark":"https://mintcdn.com/beamai/x24-0VIErdtCXs3L/logo/dark.svg?fit=max\u0026auto=format\u0026n=x24-0VIErdtCXs3L\u0026q=85\u0026s=2dcdab1858b8dd300525c3a279fbdf5b"},"favicon":"https://mintcdn.com/beamai/8A_DvJgQANsi1HxL/favicon.svg?fit=max\u0026auto=format\u0026n=8A_DvJgQANsi1HxL\u0026q=85\u0026s=402f354216350312f9109b8917ee4ab5","api":{"openapi":["openapi-final.json"],"playground":{"proxy":true},"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.beamstudio.ai"}},"navbar":{"links":[{"href":"https://app.beam.ai","label":"Platform"}],"primary":{"type":"button","label":"Request Access","href":"https://beam.ai/start"}},"footer":{"socials":{"twitter":"https://twitter.com/beam_ai","linkedin":"https://linkedin.com/company/beam-ai","discord":"https://discord.gg/beam-ai"}},"search":{"prompt":"Search Beam Academy docs..."},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"beamai","hasAudioNarration":false,"actualSubdomain":"beamai","customDomains":["docs.beam.ai"],"gitSource":{"type":"github","owner":"beam-learning","repo":"beam-academy-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ad1411f961681ba5eed1be3","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Connect API","count":51},{"language":"default","tag":"API Reference","count":51},{"language":"default","tag":"Documentation","count":34},{"language":"default","tag":"Agent Graph","count":14},{"language":"default","tag":"Agent Task","count":13},{"language":"default","tag":"Building Agents","count":11},{"language":"default","tag":"Getting Started","count":7},{"language":"default","tag":"Running \u0026 Operations","count":7},{"language":"default","tag":"Resources","count":6},{"language":"default","tag":"Agent Setup","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"h1 a[aria-label=\"Navigate to header\"],h2 a[aria-label=\"Navigate to header\"],h3 a[aria-label=\"Navigate to header\"],h4 a[aria-label=\"Navigate to header\"]{display:none}figcaption[data-component-part=\"frame-caption\"]{text-align:left;padding-left:0.5rem;padding-right:0.5rem;font-size:0.8125rem;color:rgb(107 114 128)}:is(.dark,[data-theme=\"dark\"]) figcaption[data-component-part=\"frame-caption\"]{color:rgb(115 115 125)}figcaption[data-component-part=\"frame-caption\"] p>span{color:rgb(var(--primary, 0 102 255));margin:0 0.25rem}:is(.dark,[data-theme=\"dark\"]) figcaption[data-component-part=\"frame-caption\"] p>span{color:rgb(var(--primary, 0 102 255))}.callout[data-callout-type]{background-color:rgb(249 250 251);border-color:rgb(229 231 235)}:is(.dark,[data-theme=\"dark\"]) .callout[data-callout-type]{background-color:rgb(255 255 255 / 0.04);border-color:rgb(255 255 255 / 0.10)}.callout[data-callout-type] [data-component-part=\"callout-content\"]{color:rgb(55 65 81)}:is(.dark,[data-theme=\"dark\"]) .callout[data-callout-type] [data-component-part=\"callout-content\"]{color:rgb(209 213 219)}.callout[data-callout-type] [data-component-part=\"callout-content\"] strong{color:inherit}:root{--beam-primary: rgb(var(--primary, 0 102 255));--beam-warning: hsl(41 96% 40%);--beam-success: hsl(142 72% 29%);--beam-destructive: hsl(0 84% 60%);--beam-muted: hsl(215 16% 47%)}:is(.dark,[data-theme=\"dark\"]){--beam-warning: hsl(45 93% 47%);--beam-success: hsl(142 71% 45%);--beam-muted: hsl(215 20% 65%)}.callout[data-callout-type=\"note\"] [data-component-part=\"callout-icon\"] svg,.callout[data-callout-type=\"info\"] [data-component-part=\"callout-icon\"] svg{color:var(--beam-primary)}.callout[data-callout-type=\"warning\"] [data-component-part=\"callout-icon\"] svg{color:var(--beam-warning)}.callout[data-callout-type=\"tip\"] [data-component-part=\"callout-icon\"] svg{color:var(--beam-muted)}.callout[data-callout-type=\"check\"] [data-component-part=\"callout-icon\"] svg{color:var(--beam-success)}.callout[data-callout-type=\"danger\"] [data-component-part=\"callout-icon\"] svg{color:var(--beam-destructive)}"}],"page":{"pagePath":"08-reference/api/agent-graph/create-complete-graph","slug":"/08-reference/api/agent-graph/create-complete-graph","pageMetadata":{"openapi":"post /agent-graphs/complete","title":"Create a complete agent graph","description":"Creates a new agent with its complete graph structure including nodes, edges, and tool configurations. Both an active/published graph and a draft graph are created.","href":"/08-reference/api/agent-graph/create-complete-graph"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Creates a new agent with its complete graph structure including nodes, edges, and tool configurations. Both an active/published graph and a draft graph are created.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"post /agent-graphs/complete","title":"Create a complete agent graph","description":"Creates a new agent with its complete graph structure including nodes, edges, and tool configurations. Both an active/published graph and a draft graph are created.","href":"/08-reference/api/agent-graph/create-complete-graph"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"CompleteAgentGraphController_createAgentGraph","summary":"Create a complete agent graph","description":"Creates a new agent with its complete graph structure including nodes, edges, and tool configurations. Both an active/published graph and a draft graph are created.","parameters":["b9a5ce37-fb0d-460e-877b-e0e4874ac69f"],"requestBody":"1c60f223-1696-44fa-8686-6bd411937418","responses":{"201":"08078044-1f82-459b-b99c-891978e3a748","400":"ab07aaca-7b34-4ae7-97d0-f5117613e8f4","404":"91933373-df44-4b98-b58d-a6ef014d4222","409":"c929bac0-4b19-4195-87d7-dd44e19af81b"},"tags":["Complete Agent Graph"],"security":["ebaf5d10-b849-4017-8e89-e087d677a6ba"],"method":"post","type":"path","servers":["d5cdb9a6-a2e6-4dba-9f74-b32ed729554a"],"path":"/agent-graphs/complete","baseUrlOptions":["https://api.beamstudio.ai"],"title":"Create a complete agent graph","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b9a5ce37-fb0d-460e-877b-e0e4874ac69f":{"name":"current-workspace-id","in":"header","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentName":{"type":"string","description":"The name of the agent to be created. This will be displayed in the UI and used to identify the agent","example":"Bitcoin Price Agent","isRequired":true,"uniqueKey":"agentName","typeLabel":"string"},"nodes":{"description":"The complete list of nodes that make up the agent workflow graph. Nodes are connected by edges to form the execution flow. Must include at least one entry node (isEntryNode: true). Each node can have a tool configuration and is connected to other nodes via edges","type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier (UUID). This ID is used to reference the node in edge connections (sourceAgentGraphNodeId/targetAgentGraphNodeId)","example":"d2cbeb35-9110-426c-967a-c0dba38289a9","isRequired":true,"uniqueKey":"nodes.items.[INDEX].id","typeLabel":"string"},"objective":{"type":"string","description":"The goal or purpose of this node - what the AI should accomplish when it reaches this step. This is the main instruction for the node","example":"Fetch the current Bitcoin price and return it to the user in a friendly format","isRequired":true,"uniqueKey":"nodes.items.[INDEX].objective","typeLabel":"string"},"evaluationCriteria":{"description":"List of criteria used to evaluate if the node executed successfully. Each criterion is checked after node execution","example":["The response contains a valid price number","The price is greater than 0"],"type":"array","items":{"type":"string","uniqueKey":"nodes.items.[INDEX].evaluationCriteria.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"nodes.items.[INDEX].evaluationCriteria","typeLabel":"string[]"},"isEntryNode":{"type":"boolean","description":"When true, this is the starting node of the graph. The agent begins execution here. Each graph must have exactly one entry node","example":true,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].isEntryNode","typeLabel":"boolean"},"isExitNode":{"type":"boolean","description":"When true, reaching this node ends the graph execution. A graph can have multiple exit nodes for different outcomes","example":false,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].isExitNode","typeLabel":"boolean"},"xCoordinate":{"type":"number","description":"Horizontal position (in pixels) of the node in the visual graph editor UI","example":116,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].xCoordinate","typeLabel":"number"},"yCoordinate":{"type":"number","description":"Vertical position (in pixels) of the node in the visual graph editor UI","example":150,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].yCoordinate","typeLabel":"number"},"isEvaluationEnabled":{"type":"boolean","description":"When true, the node output is evaluated against the evaluationCriteria after each execution","example":false,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].isEvaluationEnabled","typeLabel":"boolean"},"isAttachmentDataPulledIn":{"type":"boolean","description":"When true, any file attachments in the conversation are made available to this node during execution","example":true,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].isAttachmentDataPulledIn","typeLabel":"boolean"},"onError":{"type":"string","description":"Defines what happens when the node encounters an error. Options: \"STOP\" (halt execution), \"CONTINUE\" (proceed to next node)","example":"STOP","isRequired":true,"uniqueKey":"nodes.items.[INDEX].onError","typeLabel":"string"},"autoRetryWhenAccuracyLessThan":{"type":"number","description":"When enableAutoRetryWhenAccuracyIsLow is true, the node will retry if the accuracy score falls below this threshold (0-100)","example":80,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].autoRetryWhenAccuracyLessThan","typeLabel":"number"},"autoRetryLimitWhenAccuracyIsLow":{"type":"number","description":"Maximum number of retry attempts when the accuracy is below the threshold","example":1,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].autoRetryLimitWhenAccuracyIsLow","typeLabel":"number"},"autoRetryCountWhenFailure":{"type":"number","description":"Maximum number of retry attempts when the node execution fails with an error","example":1,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].autoRetryCountWhenFailure","typeLabel":"number"},"autoRetryWaitTimeWhenFailureInMs":{"type":"number","description":"Time to wait (in milliseconds) between retry attempts after a failure","example":1000,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].autoRetryWaitTimeWhenFailureInMs","typeLabel":"number"},"enableAutoRetryWhenAccuracyIsLow":{"type":"boolean","description":"When true, automatically retry the node if the accuracy score is below autoRetryWhenAccuracyLessThan","example":false,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].enableAutoRetryWhenAccuracyIsLow","typeLabel":"boolean"},"enableAutoRetryWhenFailure":{"type":"boolean","description":"When true, automatically retry the node if execution fails with an error","example":false,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].enableAutoRetryWhenFailure","typeLabel":"boolean"},"childEdges":{"description":"List of edges that go OUT from this node to other nodes. Each edge defines a possible path the agent can take after completing this node","type":"array","items":{"type":"object","properties":{"sourceAgentGraphNodeId":{"type":"string","description":"The UUID source node where this edge originates from (the \"from\" node)","example":"d2cbeb35-9110-426c-967a-c0dba38289a9","isRequired":true,"uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].sourceAgentGraphNodeId","typeLabel":"string"},"targetAgentGraphNodeId":{"type":"string","description":"The UUID of the target node where this edge leads to (the \"to\" node)","example":"22b6aa40-7d7c-449f-b151-0229834b48ba","isRequired":true,"uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].targetAgentGraphNodeId","typeLabel":"string"},"condition":{"type":"string","description":"A condition expression that must evaluate to true for the agent to follow this edge. Empty string means unconditional transition","example":"price > 50000","isRequired":true,"uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].condition","typeLabel":"string"},"isAttachmentDataPulledIn":{"type":"boolean","description":"When true, any file attachments from the conversation are passed along this edge to the next node","example":true,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].isAttachmentDataPulledIn","typeLabel":"boolean"},"conditionGroups":{"description":"Condition groups for rule-based condition evaluation","type":"array","items":{"type":"object","properties":{"rules":{"description":"Rules within this condition group","type":"array","items":{"type":"object","properties":{"sourceNodeId":{"type":"string","description":"The node ID containing the source output parameter","example":"d2cbeb35-9110-426c-967a-c0dba38289a9","isRequired":true,"uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].sourceNodeId","typeLabel":"string"},"sourceOutputParamName":{"type":"string","description":"The name of the source output parameter to compare","example":"status","isRequired":true,"uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].sourceOutputParamName","typeLabel":"string"},"operator":{"enum":["equals","not_equals","greater_than","less_than","contains","does_not_contain","starts_with","ends_with","is_empty","is_not_empty"],"type":"string","description":"The comparison operator","example":"equals","isRequired":true,"uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"comparisonValueType":{"enum":["static","output_param"],"type":"string","description":"Type of comparison value (static or output_param)","example":"static","isRequired":true,"uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].comparisonValueType","typeLabel":"enum\u003cstring>"},"comparisonValue":{"type":"string","description":"Static value to compare against (when comparisonValueType is static)","example":"success","uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].comparisonValue","typeLabel":"string"},"comparisonNodeId":{"type":"string","description":"Node ID containing the output param to compare against (when comparisonValueType is output_param)","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].comparisonNodeId","typeLabel":"string"},"comparisonOutputParamName":{"type":"string","description":"Output param name to compare against (when comparisonValueType is output_param)","example":"expectedStatus","uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].comparisonOutputParamName","typeLabel":"string"},"nextRuleOperator":{"enum":["AND","OR"],"type":"string","description":"Logical operator to connect to the next rule (AND/OR)","uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].nextRuleOperator","typeLabel":"enum\u003cstring>"}},"required":["sourceNodeId","sourceOutputParamName","operator","comparisonValueType"],"uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].conditionGroups.items.[INDEX].rules","typeLabel":"object[]"},"nextGroupOperator":{"enum":["AND","OR"],"type":"string","description":"Logical operator to connect to the next group (AND/OR)","uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].conditionGroups.items.[INDEX].nextGroupOperator","typeLabel":"enum\u003cstring>"}},"required":["rules"],"uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].conditionGroups.items.[INDEX]","typeLabel":"object"},"uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX].conditionGroups","typeLabel":"object[]"}},"required":["sourceAgentGraphNodeId","targetAgentGraphNodeId","condition","isAttachmentDataPulledIn"],"uniqueKey":"nodes.items.[INDEX].childEdges.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nodes.items.[INDEX].childEdges","typeLabel":"object[]"},"parentEdges":{"description":"List of edges that come IN to this node from other nodes. These represent the paths that lead to this node from previous steps","type":"array","items":{"type":"object","properties":{"sourceAgentGraphNodeId":{"type":"string","description":"The UUID source node where this edge originates from (the \"from\" node)","example":"d2cbeb35-9110-426c-967a-c0dba38289a9","isRequired":true,"uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].sourceAgentGraphNodeId","typeLabel":"string"},"targetAgentGraphNodeId":{"type":"string","description":"The UUID of the target node where this edge leads to (the \"to\" node)","example":"22b6aa40-7d7c-449f-b151-0229834b48ba","isRequired":true,"uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].targetAgentGraphNodeId","typeLabel":"string"},"condition":{"type":"string","description":"A condition expression that must evaluate to true for the agent to follow this edge. Empty string means unconditional transition","example":"price > 50000","isRequired":true,"uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].condition","typeLabel":"string"},"isAttachmentDataPulledIn":{"type":"boolean","description":"When true, any file attachments from the conversation are passed along this edge to the next node","example":true,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].isAttachmentDataPulledIn","typeLabel":"boolean"},"conditionGroups":{"description":"Condition groups for rule-based condition evaluation","type":"array","items":{"type":"object","properties":{"rules":{"description":"Rules within this condition group","type":"array","items":{"type":"object","properties":{"sourceNodeId":{"type":"string","description":"The node ID containing the source output parameter","example":"d2cbeb35-9110-426c-967a-c0dba38289a9","isRequired":true,"uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].sourceNodeId","typeLabel":"string"},"sourceOutputParamName":{"type":"string","description":"The name of the source output parameter to compare","example":"status","isRequired":true,"uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].sourceOutputParamName","typeLabel":"string"},"operator":{"enum":["equals","not_equals","greater_than","less_than","contains","does_not_contain","starts_with","ends_with","is_empty","is_not_empty"],"type":"string","description":"The comparison operator","example":"equals","isRequired":true,"uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"comparisonValueType":{"enum":["static","output_param"],"type":"string","description":"Type of comparison value (static or output_param)","example":"static","isRequired":true,"uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].comparisonValueType","typeLabel":"enum\u003cstring>"},"comparisonValue":{"type":"string","description":"Static value to compare against (when comparisonValueType is static)","example":"success","uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].comparisonValue","typeLabel":"string"},"comparisonNodeId":{"type":"string","description":"Node ID containing the output param to compare against (when comparisonValueType is output_param)","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].comparisonNodeId","typeLabel":"string"},"comparisonOutputParamName":{"type":"string","description":"Output param name to compare against (when comparisonValueType is output_param)","example":"expectedStatus","uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].comparisonOutputParamName","typeLabel":"string"},"nextRuleOperator":{"enum":["AND","OR"],"type":"string","description":"Logical operator to connect to the next rule (AND/OR)","uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX].nextRuleOperator","typeLabel":"enum\u003cstring>"}},"required":["sourceNodeId","sourceOutputParamName","operator","comparisonValueType"],"uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].conditionGroups.items.[INDEX].rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].conditionGroups.items.[INDEX].rules","typeLabel":"object[]"},"nextGroupOperator":{"enum":["AND","OR"],"type":"string","description":"Logical operator to connect to the next group (AND/OR)","uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].conditionGroups.items.[INDEX].nextGroupOperator","typeLabel":"enum\u003cstring>"}},"required":["rules"],"uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].conditionGroups.items.[INDEX]","typeLabel":"object"},"uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX].conditionGroups","typeLabel":"object[]"}},"required":["sourceAgentGraphNodeId","targetAgentGraphNodeId","condition","isAttachmentDataPulledIn"],"uniqueKey":"nodes.items.[INDEX].parentEdges.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nodes.items.[INDEX].parentEdges","typeLabel":"object[]"},"nodeType":{"enum":["executionNode","conditionNode","waitingNode","entryNode","exitNode","loopingNode"],"type":"string","description":"The type of node (executionNode, conditionNode, entryNode, exitNode)","example":"executionNode","uniqueKey":"nodes.items.[INDEX].nodeType","typeLabel":"enum\u003cstring>"},"nodeConfigurations":{"type":"object","description":"Configuration options for condition nodes (conditionType, llmModel)","properties":{"conditionType":{"enum":["llm_based","rule_based"],"type":"string","description":"Type of condition evaluation (llm_based or rule_based)","example":"llm_based","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.conditionType","typeLabel":"enum\u003cstring>"},"llmModel":{"type":"string","description":"The LLM model to use for condition evaluation","example":"GPT40","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.llmModel","typeLabel":"string"},"fallbackModels":{"type":"string","pattern":"/^[^\\s]*$/","description":"Comma-separated fallback models for condition evaluation","example":"GPT40,GPT4OMINI","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.fallbackModels","typeLabel":"string"},"waitType":{"enum":["time_based","condition_based"],"type":"string","description":"Type of wait (time_based or condition_based)","example":"time_based","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.waitType","typeLabel":"enum\u003cstring>"},"timeToWaitValue":{"type":"number","description":"The duration value to wait","example":5,"uniqueKey":"nodes.items.[INDEX].nodeConfigurations.timeToWaitValue","typeLabel":"number"},"timeToWaitUnit":{"enum":["minutes","hours","days","months"],"type":"string","description":"The unit of time for the wait duration","example":"minutes","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.timeToWaitUnit","typeLabel":"enum\u003cstring>"},"linkedAgentGraphNodeId":{"type":"string","description":"Custom id of the node linked to this node (e.g., source node for a variable-based loop, or the node a waiting node is linked to). The server resolves it to the persisted node id.","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.linkedAgentGraphNodeId","typeLabel":"string"},"rule":{"type":"string","description":"Rule expression for condition-based waiting","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.rule","typeLabel":"string"},"conditions":{"description":"Condition groups for condition-based waiting","type":"array","items":{"type":"object","properties":{"operator":{"enum":["AND","OR"],"type":"string","isRequired":true,"uniqueKey":"nodes.items.[INDEX].nodeConfigurations.conditions.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"type":"object","properties":{"condition":{"enum":["is","is_not","contain","does_not_contain","any","all","less_than","GREATER_than","count","exist","does_not_exist"],"type":"string","isRequired":true,"uniqueKey":"nodes.items.[INDEX].nodeConfigurations.conditions.items.[INDEX].conditions.items.[INDEX].condition","typeLabel":"enum\u003cstring>"},"operator":{"enum":["AND","OR"],"type":"string","isRequired":true,"uniqueKey":"nodes.items.[INDEX].nodeConfigurations.conditions.items.[INDEX].conditions.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"property":{"type":"string","isRequired":true,"uniqueKey":"nodes.items.[INDEX].nodeConfigurations.conditions.items.[INDEX].conditions.items.[INDEX].property","typeLabel":"string"},"value":{"type":"string","isRequired":true,"uniqueKey":"nodes.items.[INDEX].nodeConfigurations.conditions.items.[INDEX].conditions.items.[INDEX].value","typeLabel":"string"}},"required":["condition","operator","property","value"],"uniqueKey":"nodes.items.[INDEX].nodeConfigurations.conditions.items.[INDEX].conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nodes.items.[INDEX].nodeConfigurations.conditions.items.[INDEX].conditions","typeLabel":"object[]"}},"required":["operator","conditions"],"uniqueKey":"nodes.items.[INDEX].nodeConfigurations.conditions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"nodes.items.[INDEX].nodeConfigurations.conditions","typeLabel":"object[]"},"timeoutType":{"enum":["no_timeout","set_timeout"],"type":"string","description":"Timeout type for the waiting node","example":"no_timeout","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.timeoutType","typeLabel":"enum\u003cstring>"},"timeoutValue":{"type":"number","description":"Timeout duration value","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.timeoutValue","typeLabel":"number"},"timeoutUnit":{"enum":["minutes","hours","days","months"],"type":"string","description":"The unit of time for the timeout duration","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.timeoutUnit","typeLabel":"enum\u003cstring>"},"onTimeout":{"enum":["continue","fail"],"type":"string","description":"Action to take when timeout is reached (continue or fail)","example":"continue","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.onTimeout","typeLabel":"enum\u003cstring>"},"iterationCount":{"type":"number","description":"Number of iterations for a count-based loop (looping node only).","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.iterationCount","typeLabel":"number"},"linkedVariableId":{"oneOf":[{"type":"string","description":"Output parameter to loop over for a variable-based loop (looping node only). Supply as \"\u003csourceNodeCustomId>:\u003cparamName>\"; the server resolves it to the output param id.","example":"d2cbeb35-9110-426c-967a-c0dba38289a9:items","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.linkedVariableId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Output parameter to loop over for a variable-based loop (looping node only). Supply as \"\u003csourceNodeCustomId>:\u003cparamName>\"; the server resolves it to the output param id.","example":"d2cbeb35-9110-426c-967a-c0dba38289a9:items","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.linkedVariableId.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].nodeConfigurations.linkedVariableId","typeLabel":"string | null"},"alias":{"type":"string","description":"Alias for nodes inside a looping node.","uniqueKey":"nodes.items.[INDEX].nodeConfigurations.alias","typeLabel":"string"}},"uniqueKey":"nodes.items.[INDEX].nodeConfigurations","typeLabel":"object"},"toolConfiguration":{"type":"object","description":"The tool configuration for this node. If the node needs to execute a specific tool (like calling an API), configure it here. Nodes without tools are handled by the AI directly","required":["toolFunctionName","toolName","description","requiresConsent","isMemoryTool","memoryLookupInstruction","isBackgroundTool","isBatchExecutionEnabled","inputParams","outputParams"],"properties":{"toolFunctionName":{"type":"string","description":"The unique function name used to invoke this tool","example":"GPTAction_Custom_BitcoinPriceFetcher_xjUR","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.toolFunctionName","typeLabel":"string"},"toolName":{"type":"string","description":"The display name of the tool shown in the UI","example":"Bitcoin Price Fetcher","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.toolName","typeLabel":"string"},"description":{"type":"string","description":"Brief explanation of what this tool does","example":"Fetches the current Bitcoin price from CoinGecko API and returns the USD value","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.description","typeLabel":"string"},"requiresConsent":{"type":"boolean","description":"When true, the agent will ask for user confirmation before executing this tool","example":false,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.requiresConsent","typeLabel":"boolean"},"isMemoryTool":{"type":"boolean","description":"When true, this tool can access and search the agent memory/knowledge base","example":false,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.isMemoryTool","typeLabel":"boolean"},"memoryLookupInstruction":{"type":"string","description":"Instructions for how to search the memory when isMemoryTool is true","example":"","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.memoryLookupInstruction","typeLabel":"string"},"isBackgroundTool":{"type":"boolean","description":"When true, the tool runs in the background without blocking the conversation flow","example":false,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.isBackgroundTool","typeLabel":"boolean"},"isBatchExecutionEnabled":{"type":"boolean","description":"When true, the tool can process multiple items in a single execution (batch mode)","example":false,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.isBatchExecutionEnabled","typeLabel":"boolean"},"inputParams":{"description":"List of input parameters that define what data this tool needs to execute. These can be filled by AI, static values, user input, or linked from previous node outputs","type":"array","items":{"type":"object","properties":{"fillType":{"type":"string","description":"Determines how the parameter value is populated. Options: \"ai_fill\" (AI determines value), \"static\" (fixed value), \"linked\" (from previous node output), \"user_input\" (user provides value)","example":"ai_fill","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].fillType","typeLabel":"string"},"position":{"type":"number","description":"The display order position of this parameter (0-indexed). Lower numbers appear first in the UI","example":0,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].position","typeLabel":"number"},"required":{"type":"boolean","description":"Whether this parameter must be provided for the tool to execute. Required parameters must have a value","example":true,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].required","typeLabel":"boolean"},"dataType":{"type":"string","description":"The expected data type for this parameter. Common types: string, number, boolean, object, array","example":"string","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].dataType","typeLabel":"string"},"reloadProps":{"type":"boolean","description":"When true, changing this parameter value triggers a reload of dependent parameters or options","example":false,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].reloadProps","typeLabel":"boolean"},"remoteOptions":{"type":"boolean","description":"When true, the available options for this parameter are fetched from an external API rather than being static","example":false,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].remoteOptions","typeLabel":"boolean"},"paramName":{"type":"string","description":"The technical name/key of this parameter, used in API calls and data mapping","example":"api_url","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].paramName","typeLabel":"string"},"paramDescription":{"type":"string","description":"Human-readable description explaining what this parameter is for and what value is expected","example":"The URL of the API endpoint to call","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].paramDescription","typeLabel":"string"},"question":{"oneOf":[{"type":"string","description":"When fillType is \"user_input\", this question is displayed to prompt the user for input","example":"What API endpoint URL should be used?","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].question.oneOf.0","typeLabel":"string"},{"type":"null","description":"When fillType is \"user_input\", this question is displayed to prompt the user for input","example":"What API endpoint URL should be used?","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].question.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].question","typeLabel":"string | null"},"linkedOutputParamNodeId":{"oneOf":[{"type":"string","description":"When fillType is \"linked\", this is the node ID that contains the output parameter to link to","example":"d2cbeb35-9110-426c-967a-c0dba38289a9","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamNodeId.oneOf.0","typeLabel":"string"},{"type":"null","description":"When fillType is \"linked\", this is the node ID that contains the output parameter to link to","example":"d2cbeb35-9110-426c-967a-c0dba38289a9","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamNodeId.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamNodeId","typeLabel":"string | null"},"linkedOutputParamName":{"oneOf":[{"type":"string","description":"When fillType is \"linked\", this is the name of the output parameter from the referenced node to link to","example":"bitcoin_price_usd","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamName.oneOf.0","typeLabel":"string"},{"type":"null","description":"When fillType is \"linked\", this is the name of the output parameter from the referenced node to link to","example":"bitcoin_price_usd","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamName.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamName","typeLabel":"string | null"},"staticValue":{"oneOf":[{"type":"string","description":"When fillType is \"static\", this is the fixed value that will always be used for this parameter","example":"https://api.example.com/data","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].staticValue.oneOf.0","typeLabel":"string"},{"type":"null","description":"When fillType is \"static\", this is the fixed value that will always be used for this parameter","example":"https://api.example.com/data","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].staticValue.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].staticValue","typeLabel":"string | null"},"outputExample":{"oneOf":[{"type":"string","description":"An example value showing the expected format, helpful for AI or users when providing input","example":"https://api.coingecko.com/api/v3/simple/price","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].outputExample.oneOf.0","typeLabel":"string"},{"type":"null","description":"An example value showing the expected format, helpful for AI or users when providing input","example":"https://api.coingecko.com/api/v3/simple/price","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].outputExample.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].outputExample","typeLabel":"string | null"},"options":{"oneOf":[{"description":"For dropdown/select parameters, the list of available options to choose from","type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"Display label shown to users when selecting this option in a dropdown or selection UI","example":"United States","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].options.oneOf.0.items.[INDEX].label","typeLabel":"string"},"value":{"type":"string","description":"The actual value submitted when this option is selected, typically used in API calls or data processing","example":"US","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].options.oneOf.0.items.[INDEX].value","typeLabel":"string"}},"required":["label","value"],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].options.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].options.oneOf.0","typeLabel":"object[]"},{"description":"For dropdown/select parameters, the list of available options to choose from","type":"null","items":{"type":"object","properties":{"label":{"type":"string","description":"Display label shown to users when selecting this option in a dropdown or selection UI","example":"United States"},"value":{"type":"string","description":"The actual value submitted when this option is selected, typically used in API calls or data processing","example":"US"}},"required":["label","value"]},"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].options.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].options","typeLabel":"object[] | null"},"paramTip":{"oneOf":[{"type":"string","description":"Additional helpful tip or hint displayed in the UI to guide users when filling this parameter","example":"Make sure to include the full URL with protocol (https://)","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].paramTip.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional helpful tip or hint displayed in the UI to guide users when filling this parameter","example":"Make sure to include the full URL with protocol (https://)","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].paramTip.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].paramTip","typeLabel":"string | null"},"linkedOutputParamRules":{"description":"Array of linked output param rules for conditional input resolution","type":"array","items":{"type":"object","properties":{"elementKey":{"type":"string","description":"Element key for the rule.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamRules.items.[INDEX].elementKey","typeLabel":"string"},"operator":{"enum":["equals","not_equals","greater_than","less_than","contains","does_not_contain","starts_with","ends_with","is_empty","is_not_empty"],"type":"string","description":"Comparison operator for the rule.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamRules.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"comparisonValueType":{"enum":["static","output_param"],"type":"string","description":"Type of the comparison value.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamRules.items.[INDEX].comparisonValueType","typeLabel":"enum\u003cstring>"},"comparisonValue":{"oneOf":[{"type":"string","description":"Value to compare against.","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamRules.items.[INDEX].comparisonValue.oneOf.0","typeLabel":"string"},{"type":"null","description":"Value to compare against.","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamRules.items.[INDEX].comparisonValue.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamRules.items.[INDEX].comparisonValue","typeLabel":"string | null"},"nextRuleOperator":{"enum":["AND","OR"],"type":"string","description":"Logical operator linking to the next rule.","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamRules.items.[INDEX].nextRuleOperator","typeLabel":"enum\u003cstring>"}},"required":["elementKey","operator","comparisonValueType"],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamRules.items.[INDEX]","typeLabel":"object"},"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedOutputParamRules","typeLabel":"object[]"},"linkedParamRulePrompt":{"type":"string","description":"Prompt for the linked param rule (used with LLM-based conditions)","uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedParamRulePrompt","typeLabel":"string"},"linkedParamConfigurations":{"type":"object","description":"Configuration for linked param condition (conditionType, llmModel)","properties":{"conditionType":{"type":"string","enum":["llm_based","rule_based"],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedParamConfigurations.conditionType","typeLabel":"enum\u003cstring>"}},"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX].linkedParamConfigurations","typeLabel":"object"}},"required":["fillType","position","required","dataType","reloadProps","remoteOptions","paramName","paramDescription"],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.inputParams","typeLabel":"object[]"},"outputParams":{"description":"List of output parameters that this tool produces after execution. These outputs can be linked to input parameters of subsequent nodes in the graph","type":"array","items":{"type":"object","properties":{"isArray":{"type":"boolean","description":"Whether this output parameter returns an array of values rather than a single value","example":false,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].isArray","typeLabel":"boolean"},"paramName":{"type":"string","description":"The technical name/key of this output parameter, used when accessing the value in subsequent nodes","example":"bitcoin_price_usd","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].paramName","typeLabel":"string"},"position":{"type":"number","description":"The display order position of this parameter (0-indexed). Lower numbers appear first in the UI","example":0,"isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].position","typeLabel":"number"},"paramDescription":{"type":"string","description":"Human-readable description explaining what this output contains and how it can be used","example":"The current price of Bitcoin in USD, extracted from the API response","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].paramDescription","typeLabel":"string"},"dataType":{"type":"string","description":"The data type of this output. Common types: string, number, boolean, object, array","example":"number","isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].dataType","typeLabel":"string"},"parentId":{"oneOf":[{"type":"string","description":"For nested/hierarchical outputs, the UUID of the parent parameter. Null for top-level parameters","example":null,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].parentId.oneOf.0","typeLabel":"string"},{"type":"null","description":"For nested/hierarchical outputs, the UUID of the parent parameter. Null for top-level parameters","example":null,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].parentId.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].parentId","typeLabel":"string | null"},"paramPath":{"oneOf":[{"type":"string","description":"JSON path showing where this value is located in a nested response structure","example":"data.bitcoin.usd","uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].paramPath.oneOf.0","typeLabel":"string"},{"type":"null","description":"JSON path showing where this value is located in a nested response structure","example":"data.bitcoin.usd","uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].paramPath.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].paramPath","typeLabel":"string | null"},"outputExample":{"type":"string","description":"Example value demonstrating the expected output format","example":"94523.50","uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].outputExample","typeLabel":"string"},"typeOptions":{"oneOf":[{"type":"object","description":"Additional type configuration (e.g., enum values, format specifications, nested structure definitions)","example":{"format":"currency","precision":2},"uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].typeOptions.oneOf.0","typeLabel":"object"},{"type":"null","description":"Additional type configuration (e.g., enum values, format specifications, nested structure definitions)","example":{"format":"currency","precision":2},"uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].typeOptions.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX].typeOptions","typeLabel":"object | null"}},"required":["isArray","paramName","position","paramDescription","dataType"],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.outputParams","typeLabel":"object[]"},"iconSrc":{"oneOf":[{"type":"string","description":"URL to the tool icon image","example":null,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.iconSrc.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL to the tool icon image","example":null,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.iconSrc.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.iconSrc","typeLabel":"string | null"},"accuracyScore":{"oneOf":[{"type":"number","description":"A score (0-100) indicating the historical accuracy/success rate of this tool. Null if not yet measured","example":null,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.accuracyScore.oneOf.0","typeLabel":"number"},{"type":"null","description":"A score (0-100) indicating the historical accuracy/success rate of this tool. Null if not yet measured","example":null,"uniqueKey":"nodes.items.[INDEX].toolConfiguration.accuracyScore.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.accuracyScore","typeLabel":"number | null"},"preferredModel":{"oneOf":[{"type":"string","description":"The preferred AI model to use when executing this tool. If not specified, the system default model will be used. Common values: \"gpt-4\", \"gpt-4o\", \"gpt-3.5-turbo\"","example":"gpt-4o","uniqueKey":"nodes.items.[INDEX].toolConfiguration.preferredModel.oneOf.0","typeLabel":"string"},{"type":"null","description":"The preferred AI model to use when executing this tool. If not specified, the system default model will be used. Common values: \"gpt-4\", \"gpt-4o\", \"gpt-3.5-turbo\"","example":"gpt-4o","uniqueKey":"nodes.items.[INDEX].toolConfiguration.preferredModel.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.preferredModel","typeLabel":"string | null"},"fallbackModels":{"oneOf":[{"type":"string","pattern":"/^[^\\s]*$/","description":"Comma-separated list of fallback models. No spaces allowed.","example":"DEEP_SEEK,BEDROCK_CLAUDE_3_7_SONNET,BEDROCK_CLAUDE_OPUS_4_5","uniqueKey":"nodes.items.[INDEX].toolConfiguration.fallbackModels.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"/^[^\\s]*$/","description":"Comma-separated list of fallback models. No spaces allowed.","example":"DEEP_SEEK,BEDROCK_CLAUDE_3_7_SONNET,BEDROCK_CLAUDE_OPUS_4_5","uniqueKey":"nodes.items.[INDEX].toolConfiguration.fallbackModels.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.fallbackModels","typeLabel":"string | null"},"prompt":{"oneOf":[{"type":"string","description":"The prompt template that guides the AI when executing this tool. This defines how the AI should process inputs and generate outputs. Required for custom GPT tools","example":"You are a helpful assistant. Given the input parameters, fetch the current Bitcoin price and return it in a user-friendly format.","uniqueKey":"nodes.items.[INDEX].toolConfiguration.prompt.oneOf.0","typeLabel":"string"},{"type":"null","description":"The prompt template that guides the AI when executing this tool. This defines how the AI should process inputs and generate outputs. Required for custom GPT tools","example":"You are a helpful assistant. Given the input parameters, fetch the current Bitcoin price and return it in a user-friendly format.","uniqueKey":"nodes.items.[INDEX].toolConfiguration.prompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].toolConfiguration.prompt","typeLabel":"string | null"}},"uniqueKey":"nodes.items.[INDEX].toolConfiguration","typeLabel":"object"},"parentNodeId":{"oneOf":[{"type":"string","description":"The customId of the parent loop node when this node is a child inside a loop. Used to associate loop body nodes with their parent loop.","example":"d2cbeb35-9110-426c-967a-c0dba38289a9","uniqueKey":"nodes.items.[INDEX].parentNodeId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The customId of the parent loop node when this node is a child inside a loop. Used to associate loop body nodes with their parent loop.","example":"d2cbeb35-9110-426c-967a-c0dba38289a9","uniqueKey":"nodes.items.[INDEX].parentNodeId.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].parentNodeId","typeLabel":"string | null"}},"required":["id","objective","evaluationCriteria","isEntryNode","isExitNode","xCoordinate","yCoordinate","isEvaluationEnabled","isAttachmentDataPulledIn","onError","autoRetryWhenAccuracyLessThan","autoRetryLimitWhenAccuracyIsLow","autoRetryCountWhenFailure","autoRetryWaitTimeWhenFailureInMs","enableAutoRetryWhenAccuracyIsLow","enableAutoRetryWhenFailure","childEdges","parentEdges"],"uniqueKey":"nodes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nodes","typeLabel":"object[]"},"agentDescription":{"type":"string","description":"A detailed description of what the agent does and its capabilities","example":"An AI agent that fetches real-time cryptocurrency prices and provides market insights","uniqueKey":"agentDescription","typeLabel":"string"},"settings":{"type":"object","description":"Configuration settings for the agent including personality, restrictions, and suggested prompts","properties":{"prompts":{"description":"List of suggested prompts shown to users as conversation starters. These help users understand what the agent can do","example":["What is the current Bitcoin price?","Can you fetch the latest cryptocurrency rates?"],"type":"array","items":{"type":"string","uniqueKey":"settings.prompts.items.[INDEX]","typeLabel":"string"},"uniqueKey":"settings.prompts","typeLabel":"string[]"}},"uniqueKey":"settings","typeLabel":"object"}},"required":["agentName","nodes"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"agentName":"Bitcoin Price Agent","nodes":[{"id":"d2cbeb35-9110-426c-967a-c0dba38289a9","objective":"Fetch the current Bitcoin price and return it to the user in a friendly format","evaluationCriteria":["The response contains a valid price number","The price is greater than 0"],"isEntryNode":true,"isExitNode":false,"xCoordinate":116,"yCoordinate":150,"isEvaluationEnabled":false,"isAttachmentDataPulledIn":true,"onError":"STOP","autoRetryWhenAccuracyLessThan":80,"autoRetryLimitWhenAccuracyIsLow":1,"autoRetryCountWhenFailure":1,"autoRetryWaitTimeWhenFailureInMs":1000,"enableAutoRetryWhenAccuracyIsLow":false,"enableAutoRetryWhenFailure":false,"childEdges":[{"sourceAgentGraphNodeId":"d2cbeb35-9110-426c-967a-c0dba38289a9","targetAgentGraphNodeId":"22b6aa40-7d7c-449f-b151-0229834b48ba","condition":"price > 50000","isAttachmentDataPulledIn":true,"conditionGroups":[{"rules":[{"sourceNodeId":"d2cbeb35-9110-426c-967a-c0dba38289a9","sourceOutputParamName":"status","operator":"equals","comparisonValueType":"static","comparisonValue":"success","comparisonNodeId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","comparisonOutputParamName":"expectedStatus"}]}]}],"parentEdges":[{"sourceAgentGraphNodeId":"d2cbeb35-9110-426c-967a-c0dba38289a9","targetAgentGraphNodeId":"22b6aa40-7d7c-449f-b151-0229834b48ba","condition":"price > 50000","isAttachmentDataPulledIn":true,"conditionGroups":[{"rules":[{"sourceNodeId":"d2cbeb35-9110-426c-967a-c0dba38289a9","sourceOutputParamName":"status","operator":"equals","comparisonValueType":"static","comparisonValue":"success","comparisonNodeId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","comparisonOutputParamName":"expectedStatus"}]}]}],"nodeType":"executionNode","nodeConfigurations":{"conditionType":"llm_based","llmModel":"GPT40","fallbackModels":"GPT40,GPT4OMINI","waitType":"time_based","timeToWaitValue":5,"timeToWaitUnit":"minutes","linkedAgentGraphNodeId":"\u003cstring>","rule":"\u003cstring>","conditions":[{"conditions":[{"property":"\u003cstring>","value":"\u003cstring>"}]}],"timeoutType":"no_timeout","timeoutValue":123,"onTimeout":"continue","iterationCount":123,"linkedVariableId":"d2cbeb35-9110-426c-967a-c0dba38289a9:items","alias":"\u003cstring>"},"parentNodeId":"d2cbeb35-9110-426c-967a-c0dba38289a9"}],"agentDescription":"An AI agent that fetches real-time cryptocurrency prices and provides market insights","settings":{"prompts":["What is the current Bitcoin price?","Can you fetch the latest cryptocurrency rates?"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"08078044-1f82-459b-b99c-891978e3a748":{"description":"Agent and graph created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"agentId":{"type":"string","description":"UUID of the created agent","example":"f47ac10b-58cc-4372-a567-0e02b2c3d479","format":"uuid","isRequired":true,"uniqueKey":"agentId","typeLabel":"string\u003cuuid>"},"agentName":{"type":"string","description":"Name of the created agent","example":"My AI Agent","isRequired":true,"uniqueKey":"agentName","typeLabel":"string"},"activeGraphId":{"type":"string","description":"UUID of the active/published graph","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","format":"uuid","isRequired":true,"uniqueKey":"activeGraphId","typeLabel":"string\u003cuuid>"},"draftGraphId":{"type":"string","description":"UUID of the draft graph","example":"b2c3d4e5-f6a7-8901-bcde-f12345678901","format":"uuid","isRequired":true,"uniqueKey":"draftGraphId","typeLabel":"string\u003cuuid>"}},"required":["agentId","agentName","activeGraphId","draftGraphId"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"agentId":"f47ac10b-58cc-4372-a567-0e02b2c3d479","agentName":"My AI Agent","activeGraphId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","draftGraphId":"b2c3d4e5-f6a7-8901-bcde-f12345678901"}}},"exampleType":"generated"}},"exampleType":"generated"},"ab07aaca-7b34-4ae7-97d0-f5117613e8f4":{"description":"Bad Request - Invalid input data","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"91933373-df44-4b98-b58d-a6ef014d4222":{"description":"Tool not found and no originalTool data provided","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"c929bac0-4b19-4195-87d7-dd44e19af81b":{"description":"Conflict - Invalid tool type provided","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"ebaf5d10-b849-4017-8e89-e087d677a6ba":{"x-api-key":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[]}}},"servers":{"d5cdb9a6-a2e6-4dba-9f74-b32ed729554a":{"url":"https://api.beamstudio.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[]},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"x-api-key","name":"x-api-key"}],"title":"x-api-key"}]},"originalFileLocation":"openapi-final.json"},"subdomain":"beamai","siteName":"Beam Academy","title":"Create a complete agent graph - Beam Academy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-12T12:04:23.727Z","originalFileLocation":"08-reference/api/agent-graph/create-complete-graph.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creates a new agent with its complete graph structure including nodes, edges, and tool configurations. Both an active/published graph and a draft graph are created.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Beam Academy\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/beamai/9X8qy_7w-d2tghjB/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/beamai/9X8qy_7w-d2tghjB/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/beamai/9X8qy_7w-d2tghjB/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/beamai/9X8qy_7w-d2tghjB/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/beamai/9X8qy_7w-d2tghjB/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/beamai/9X8qy_7w-d2tghjB/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/beamai/9X8qy_7w-d2tghjB/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/beamai/9X8qy_7w-d2tghjB/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/beamai/9X8qy_7w-d2tghjB/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a complete agent graph - Beam Academy\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new agent with its complete graph structure including nodes, edges, and tool configurations. Both an active/published graph and a draft graph are created.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Beam Academy\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.beam.ai/08-reference/api/agent-graph/create-complete-graph\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://beamai.mintlify.site/_mintlify/api/og/v2?division=Agent+Graph\u0026amp;title=Create+a+complete+agent+graph\u0026amp;description=Creates+a+new+agent+with+its+complete+graph+structure+including+nodes%2C+edges%2C+and+tool+configurations.+Both+an+active%2Fpublished+graph+and+a+draft+graph+are+crea\u0026amp;theme=0940edf4ff85089b01989c48\u0026amp;signature=b5c16557a0d4f7ca66c82803bc6d1dd4810cae1fa296daffda1bcabf55c88d5f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a complete agent graph - Beam Academy\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new agent with its complete graph structure including nodes, edges, and tool configurations. Both an active/published graph and a draft graph are created.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://beamai.mintlify.site/_mintlify/api/og/v2?division=Agent+Graph\u0026amp;title=Create+a+complete+agent+graph\u0026amp;description=Creates+a+new+agent+with+its+complete+graph+structure+including+nodes%2C+edges%2C+and+tool+configurations.+Both+an+active%2Fpublished+graph+and+a+draft+graph+are+crea\u0026amp;theme=0940edf4ff85089b01989c48\u0026amp;signature=b5c16557a0d4f7ca66c82803bc6d1dd4810cae1fa296daffda1bcabf55c88d5f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/beamai/9X8qy_7w-d2tghjB/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Beam Academy\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0066FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.beam.ai/08-reference/api/agent-graph/create-complete-graph\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/08-reference/api/agent-graph/create-complete-graph.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.beam.ai/#organization\",\"name\":\"Beam Academy\",\"url\":\"https://docs.beam.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/beamai/x24-0VIErdtCXs3L/logo/light.svg?fit=max\u0026auto=format\u0026n=x24-0VIErdtCXs3L\u0026q=85\u0026s=7e65c5198f77ddd8b74f371dccb787f0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.beam.ai#website\",\"name\":\"Beam Academy\",\"url\":\"https://docs.beam.ai\",\"publisher\":{\"@id\":\"https://docs.beam.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.beam.ai/08-reference/api/agent-graph/create-complete-graph#webpage\",\"url\":\"https://docs.beam.ai/08-reference/api/agent-graph/create-complete-graph\",\"name\":\"Create a complete agent graph\",\"description\":\"Creates a new agent with its complete graph structure including nodes, edges, and tool configurations. Both an active/published graph and a draft graph are created.\",\"dateModified\":\"2026-09-12T12:04:23.727Z\",\"isPartOf\":{\"@id\":\"https://docs.beam.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.beam.ai/08-reference/api/agent-graph/create-complete-graph#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.beam.ai/08-reference/api/agent-graph/create-complete-graph#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.beam.ai/08-reference/api/overview/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a complete agent graph\",\"item\":\"https://docs.beam.ai/08-reference/api/agent-graph/create-complete-graph\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.beam.ai/08-reference/api/agent-graph/create-complete-graph#apireference\",\"headline\":\"Create a complete agent graph\",\"name\":\"Create a complete agent graph\",\"description\":\"Creates a new agent with its complete graph structure including nodes, edges, and tool configurations. Both an active/published graph and a draft graph are created.\",\"url\":\"https://docs.beam.ai/08-reference/api/agent-graph/create-complete-graph\",\"mainEntityOfPage\":{\"@id\":\"https://docs.beam.ai/08-reference/api/agent-graph/create-complete-graph#webpage\"},\"dateModified\":\"2026-09-12T12:04:23.727Z\",\"publisher\":{\"@id\":\"https://docs.beam.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.beam.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Beam Academy\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Beam Academy\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/08-reference/api/agent-graph/create-complete-graph.md","siteName":"Beam Academy","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/01-getting-started/welcome/welcome"}]},{"tab":"Connect API","groups":[{"group":"API Reference","pages":[{"title":"API Overview","href":"/08-reference/api/overview/overview"},{"title":"Authentication","href":"/08-reference/api/authentication/authentication"},{"title":"MCP Connection","href":"/08-reference/api/mcp-connection/mcp-connection"},{"group":"User","pages":[{"openapi":"get /v2/user/me","title":"Get Current User","href":"/08-reference/api/user/get-current-user"}]},{"group":"Agents","pages":[{"openapi":"get /agent","title":"List Agents","href":"/08-reference/api/agents/list-agents"},{"openapi":"put /agent/{agentId}","title":"Update Agent","href":"/08-reference/api/agents/update-agent"}]},{"group":"Agent Context Files","pages":[{"openapi":"get /context/agent/{agentId}/file/{fileId}/download","title":"Download Context File","href":"/08-reference/api/agent-context-files/download-context-file"},{"openapi":"post /context/agent/{agentId}/file","title":"Upload Context File","href":"/08-reference/api/agent-context-files/upload-context-file"},{"openapi":"delete /context/agent/{agentId}/file/{fileKey}","title":"Delete Context File","href":"/08-reference/api/agent-context-files/delete-context-file"}]},{"group":"Agent Skills","pages":[{"openapi":"post /agent/{agentId}/skills/import","title":"Import a skill from a zip file","description":"Import a skill into an agent from a zip file. The zip file should contain the skill configuration and any associated assets. The skill will be added to the specified agent.","href":"/08-reference/api/agent-skills/import-skill"}]},{"group":"Agent Graph","pages":[{"openapi":"post /agent-graphs/complete","title":"Create a complete agent graph","href":"/08-reference/api/agent-graph/create-complete-graph"},{"openapi":"put /agent-graphs/{agentId}","title":"Update agent and its draft graph","description":"Updates an existing agent (name, description, settings) and replaces all nodes and edges in its draft graph.","href":"/08-reference/api/agent-graph/update-agent-graph"},{"openapi":"post /agent-graphs/test-node","title":"Test Graph Node","href":"/08-reference/api/agent-graph/test-graph-node"},{"openapi":"get /agent-graphs/{agentId}","title":"Get Agent Graph","href":"/08-reference/api/agent-graph/get-agent-graph"},{"openapi":"get /agent-graphs/{agentId}/nodes/lite","title":"Get Agent Graph with nodes","href":"/08-reference/api/agent-graph/get-agent-graph-with-nodes"},{"openapi":"get /agent-graphs/{agentId}/nodes/{nodeId}","title":"Get detailed information for a specific node","href":"/08-reference/api/agent-graph/get-detailed-information-for-a-specific-node"},{"openapi":"get /agent-graphs/agent-task-nodes/{toolFunctionName}","title":"Get Task Nodes by Tool","href":"/08-reference/api/agent-graph/get-task-nodes-by-tool"},{"openapi":"patch /agent-graphs/update-node","title":"Update Graph Node","href":"/08-reference/api/agent-graph/update-graph-node"},{"openapi":"put /agent-graphs/update-edge/{edgeId}","title":"Update Edge in Graph","href":"/08-reference/api/agent-graph/update-edge-in-graph"},{"openapi":"patch /agent-graphs/{agentId}/nodes/{nodeId}/input-output-params","title":"Update input/output parameters for a node tool configuration","href":"/08-reference/api/agent-graph/update-inputoutput-parameters-for-a-node-tool-configuration"},{"openapi":"patch /agent-graphs/{agentId}/nodes/{nodeId}/prompt","title":"Update prompt of the tool","href":"/08-reference/api/agent-graph/update-prompt-of-the-tool"},{"openapi":"patch /agent-graphs/{graphId}/publish","title":null,"href":"/08-reference/api/agent-graph/publish-agent-graph"},{"openapi":"post /agent-graphs/add-node","title":"Add Node to Graph","href":"/08-reference/api/agent-graph/add-node-to-graph"},{"openapi":"post /agent-graphs/add-edge","title":"Add Edge to Graph","href":"/08-reference/api/agent-graph/add-edge-to-graph"}]},{"group":"Custom Tool","pages":[{"openapi":"get /custom-tool/preferred-models","title":null,"href":"/08-reference/api/custom-tool/get-preferred-models"}]},{"group":"Agent Setup","pages":[{"openapi":"get /agent-setup/session/{agentId}","title":"Get agent setup session","href":"/08-reference/api/agent-setup/get-agent-setup-session"},{"openapi":"post /agent-setup","title":"Process agent setup steps","href":"/08-reference/api/agent-setup/process-agent-setup-steps"},{"openapi":"post /agent-setup/agent-context/feedback","title":"Submit feedback on the provided context","href":"/08-reference/api/agent-setup/submit-context-feedback"},{"openapi":"post /agent-setup/{agentId}/{setupStep}/feedback","title":"Provide feedback for a specific setup step","href":"/08-reference/api/agent-setup/submit-step-feedback"},{"openapi":"post /agent-setup/upload","title":"Upload context files during agent setup","href":"/08-reference/api/agent-setup/upload-context-files"},{"openapi":"post /agent-setup/{agentId}/context-file","title":"Add context files to an existing agent","href":"/08-reference/api/agent-setup/add-context-files"}]},{"group":"Agent Task","pages":[{"openapi":"get /agent-tasks/{taskId}/updates","title":"Get Task Updates (SSE)","href":"/08-reference/api/agent-task/get-task-updates-sse"},{"openapi":"get /agent-tasks","title":"List Agent Tasks","href":"/08-reference/api/agent-task/list-agent-tasks"},{"openapi":"post /agent-tasks","title":"Create Agent Task","href":"/08-reference/api/agent-task/create-agent-task"},{"openapi":"get /agent-tasks/analytics","title":"Get Agent Analytics","href":"/08-reference/api/agent-task/get-agent-analytics"},{"openapi":"patch /agent-tasks/execution/{taskId}/user-input","title":"Submit User Input","href":"/08-reference/api/agent-task/submit-user-input"},{"openapi":"post /agent-tasks/execution/{taskId}/rejection","title":"Reject Task Execution","href":"/08-reference/api/agent-task/reject-task-execution"},{"openapi":"post /agent-tasks/execution/{taskId}/user-consent","title":"Approve Task Execution","href":"/08-reference/api/agent-task/approve-task-execution"},{"openapi":"get /agent-tasks/latest-executions","title":"Get Latest Task Executions","href":"/08-reference/api/agent-task/get-latest-task-executions"},{"openapi":"get /agent-tasks/iterate","title":"Get Next Task","href":"/08-reference/api/agent-task/get-next-task"},{"openapi":"patch /agent-tasks/execution/{taskId}/output-rating","title":"Rate Task Output","href":"/08-reference/api/agent-task/rate-task-output"},{"openapi":"get /agent-tasks/tool-output-schema/{graphNodeId}","title":"Get Tool Output Schema","href":"/08-reference/api/agent-task/get-tool-output-schema"},{"openapi":"post /agent-tasks/retry","title":"Retry Task Execution","href":"/08-reference/api/agent-task/retry-task-execution"},{"openapi":"get /agent-tasks/{taskId}","title":"Get Task Details","href":"/08-reference/api/agent-task/get-task-details"}]},{"group":"Agent Views","pages":[{"openapi":"get /agent-views","title":"List all views","href":"/08-reference/api/agent-views/list-all-views"},{"openapi":"get /agent-views/{viewId}","title":"Get a view by ID","href":"/08-reference/api/agent-views/get-a-view-by-id"},{"openapi":"get /agent-views/{viewId}/records","title":"List records from a view","href":"/08-reference/api/agent-views/list-records-from-a-view"},{"openapi":"get /agent-views/{viewId}/columns/{columnId}/links/{recordId}","title":"List linked records for a link column","href":"/08-reference/api/agent-views/list-linked-records-for-a-link-column"}]},{"group":"Tool","pages":[{"openapi":"get /tool/active-tools","title":"Get Active Tools","href":"/08-reference/api/tool/get-active-tools"},{"openapi":"post /tool/optimize/{toolFunctionName}","title":"Optimize Tool","href":"/08-reference/api/tool/optimize-tool"},{"openapi":"post /tool/optimization-status/thread/{threadId}","title":"Get Tool Optimization Status","href":"/08-reference/api/tool/get-tool-optimization-status"}]}]}]}]},"basePath":"","title":"Create a complete agent graph - Beam Academy","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}