Skip to main content
QUERY
nodeByNs(ns: String!, page: Int, perPage: Int, ids: [String], excludeIds: Boolean, searchValue: String, sortField: String, sortDirection: SortDirection, status: String, tagIds: [String], untagged: Boolean, folderTagId: String): Node

Arguments

ns
String!
required
page
Int
perPage
Int
ids
[String]
excludeIds
Boolean
searchValue
String
sortField
String
sortDirection
SortDirection
status
String
tagIds
[String]
untagged
Boolean
folderTagId
String

Returns

Node
_id
String

Unique node document id.

ns
String

Namespace, unique within the parent automation — addressable from goto/nextNodeNs references.

type
String

Node kind (e.g. action, condition, split, sendEmail, aiAssistant, copilotAgent, goto). See automationCatalog for the full catalog.

automationId
String

Parent Automation _id.

automationNs
String

Parent automation's ns.

automationName
String

Parent automation's name, denormalized for display.

style
JSON

Canvas styling (color, etc.) — opaque to execution.

status
String

Mirrors the parent automation's status (draft, live, offline, archived, version).

connections
JSON

Outbound wiring to other nodes on the canvas.

messages
JSON

Message step content, when type is a messaging action.

question
JSON

Question/input step configuration.

conditions
JSON

Branching rules, when type is condition.

aiAssistant
JSON

AI Assistant step configuration, when type is aiAssistant.

copilotAgent
JSON

Copilot agent step configuration, when type is copilotAgent.

split
JSON

A/B split configuration, when type is split.

actions
JSON

Action-specific payload for generic action nodes.

sendEmail
JSON

Email step configuration, when type is sendEmail.

goto
JSON

Jump target, when type is goto.

note
JSON

Freeform builder annotation attached to this node (separate from AutomationNote).

icon
String

Icon identifier shown on the canvas.

label
String

Display label shown on the canvas.

description
String

Optional longer description shown in the builder.

position
JSON

Canvas { x, y } coordinates. Bulk-update with batchSavePositions.

workflowId
String

Reserved for future workflow grouping; not currently populated.

nextNodeNs
String

Default next node when this node has no branching outputs.

isMacro
Boolean

Whether this node is a reusable macro — see macros.

metadata
JSON

Free-form metadata bag for plugin-specific extensions.

createdAt
Date

When this node was created.

updatedAt
Date

When this node was last modified.

createdBy
String

User id who created this node.

updatedBy
String

User id who last modified this node.

Query
Variables
Response
آخر تعديل في ١١ أغسطس ٢٠٢٦