Flows
Create flow node
Creates a node in a flow graph. The server assigns nodeId and alias; use the 201 response when adding edges or updates.
post/public/v1/agents/{agentId}/flows/{flowId}/nodes
Path parameters
agentIdstring required
Example:uuid-xxxx-xxxx
flowIdnumber nullable
Example:101
Request body
Example request
{
"node": {
"name": "Start",
"position": {
"positionX": 1,
"positionY": 1
},
"type": "START",
"data": {
"type": "TRIGGER_INTENT",
"agenticRouting": "example",
"intentIds": [
1
],
"intents": [
{
"id": 1,
"name": "example",
"description": "example",
"createdAt": "example",
"updatedAt": "example",
"status": "ACTIVE",
"assistantId": "example",
"phrases": [
{
"id": 1,
"phrase": "example"
}
],
"flowId": 1
}
]
}
}
}Response
Created node
Example response
{
"nodeId": "node_550e8400-e29b-41d4-a716-446655440000",
"alias": "Say",
"name": "Start",
"position": {
"positionX": 1,
"positionY": 1
},
"type": "START",
"data": {
"type": "TRIGGER_INTENT",
"agenticRouting": "example",
"intentIds": [
1
],
"intents": [
{
"id": 1,
"name": "example",
"description": "example",
"createdAt": "example",
"updatedAt": "example",
"status": "ACTIVE",
"assistantId": "example",
"phrases": [
{
"id": 1,
"phrase": "example"
}
],
"flowId": 1
}
]
},
"workflowId": "example",
"handles": [
{
"handleId": "example",
"sourceEdge": {
"from": "example",
"fromHandleId": "example",
"to": "example",
"toHandleId": "example"
},
"text": "example"
}
],
"targetEdges": [
{
"from": "example",
"fromHandleId": "example",
"to": "example",
"toHandleId": "example"
}
],
"createdAt": "example",
"updatedAt": "example"
}