Add Workflow Node

Add a node to a workflow DAG (action, agent, or advanced) and wire its edges. Cycles are rejected.

post/v1/workflows/{workflow_id}/nodes

Request

Base URL
https://api.xpander.ai (the document declares no server; this is the origin it was published from)
Auth
API key in header x-api-key

Path parameters

workflow_idstring required

Query parameters

deployboolean

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

Request body

type'action' | 'agent' | 'advanced' required

Node kind to add.

namestring nullable

Node name.

connection_idstring nullable

Connection id. Required for type=action.

operation_idstring nullable

Operation catalog id. Required for type=action.

instructionsstring nullable

Instructions for the action/agent node.

agent_idstring nullable

Agent id. Required for type=agent.

after_node_idsstring[] nullable

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

next_node_idsstring[] nullable

Ids of nodes to run after the new node.

Response

Successful Response

idstring required

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

typestring required

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

namestring nullable

Node name.

next_node_idsstring[]

Ids of nodes that run after this one.

asset_idstring nullable

Referenced asset id for action/agent nodes.

connection_idstring nullable

Connection id parsed from an action node's asset_id.

operation_idstring nullable

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

target_agent_idstring nullable

Agent id for agent nodes.

Changes

No recorded changes to this operation across all 4 revisions of this API.