Skip to main content
POST
/
v1
/
workflows
/
{id}
/
nodes
Add a node to a workflow
curl --request POST \
  --url https://app.galaxy.ai/api/v1/workflows/{id}/nodes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "nodeType": "<string>",
  "column": 2,
  "row": 1,
  "inputs": {},
  "mode": "<string>"
}
'
{
  "nodeId": "<string>",
  "type": "<string>",
  "position": {
    "x": 123,
    "y": 123
  },
  "inputPorts": [
    "<string>"
  ],
  "outputPorts": [
    "<string>"
  ],
  "mode": "<string>",
  "inputsSet": [
    "<string>"
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Workflow ID

Minimum string length: 1

Body

application/json
​
nodeType
string
required

Node type key (e.g. 'gpt_5_4', 'flux_2_pro'). Use list_node_types to see options.

Minimum string length: 1
​
position
object

Exact canvas position. Overrides column/row. Auto-calculated if omitted.

​
column
integer

Batch column (1-indexed). Column 1 = first processing batch after Request.

Required range: x >= 1
​
row
integer

Row within column (0-indexed). Used to stack parallel nodes vertically.

Required range: x >= 0
​
inputs
object

Input field values to set on the node (e.g. { system_prompt: 'You are helpful' }).

​
mode
string

Sub-model mode for multi-mode nodes (e.g. 'text-to-image', 'image-to-image').

Response

Successful response

​
nodeId
string
required
​
type
string
required
​
position
object
required
​
inputPorts
string[]
required
​
outputPorts
string[]
required
​
mode
string
​
inputsSet
string[]