Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

Authentication header containing API key (find it in dashboard). The format is "Bearer YOUR_API_KEY"

Body

application/json
name
string
required

Name of the component

Example:

"Customer Information Collector"

nodes
object · object · object · any · any · any · any · any · any · any · any · any · object · any · any[]
required

Nodes that make up the component

Example:
flex_mode
boolean | null

If enabled, the whole component will be converted as a Single Prompt agent.

Example:

false

tools
object[] | null

Tools available within the component

Example:
mcps
object[] | null

A list of MCP server configurations to use for this component

start_node_id
string | null

ID of the starting node

Example:

"collect_info"

begin_tag_display_position
object | null

Display position for the begin tag in the frontend

notes
object[] | null

Visual annotations displayed on the flow canvas.

Response

Successfully created conversation flow component

name
string
required

Name of the component

Example:

"Customer Information Collector"

nodes
object · any · any · any · any · any · any · any · any · any · any · any · object · any · any[]
required

Nodes that make up the component

Example:
conversation_flow_component_id
string
required

Unique identifier for the component

user_modified_timestamp
integer<int64>
required

Timestamp of last user modification

flex_mode
boolean | null

If enabled, the whole component will be converted as a Single Prompt agent.

Example:

false

tools
object[] | null

Tools available within the component

Example:
mcps
object[] | null

A list of MCP server configurations to use for this component

start_node_id
string | null

ID of the starting node

Example:

"collect_info"

begin_tag_display_position
object | null

Display position for the begin tag in the frontend

notes
object[] | null

Visual annotations displayed on the flow canvas.

linked_conversation_flow_ids
string[]

IDs of conversation flows linked to this shared component