Skip to main content
POST
Add Workflow Node

Authorizations

x-api-key
string
header
required

API Key for authentication

Path Parameters

workflow_id
string
required

Query Parameters

deploy
boolean
default:true

Deploy the workflow after adding so the change takes effect immediately.

Body

application/json

Add a node to a workflow DAG. Use action/agent for the common cases, or advanced for full control.

type
enum<string>
required

Node kind to add.

Available options:
action,
agent,
advanced
name
string | null

Node name.

connection_id
string | null

Connection id. Required for type=action.

operation_id
string | null

Operation catalog id. Required for type=action.

instructions
string | null

Instructions for the action/agent node.

agent_id
string | null

Agent id. Required for type=agent.

advanced
OrchestrationNode · object | null

A full OrchestrationNode. Required for type=advanced.

after_node_ids
string[] | null

Append the new node id to the next_node_ids of these existing nodes.

next_node_ids
string[] | null

Ids of nodes to run after the new node.

Response

Successful Response

id
string
required

Node id (use to update/remove the node).

type
string
required

Node type (action, agent, classifier, ...).

name
string | null

Node name.

next_node_ids
string[]

Ids of nodes that run after this one.

asset_id
string | null

Referenced asset id for action/agent nodes.

connection_id
string | null

Connection id parsed from an action node's asset_id.

operation_id
string | null

Operation catalog id parsed from an action node's asset_id.

target_agent_id
string | null

Agent id for agent nodes.