> ## Documentation Index
> Fetch the complete documentation index at: https://docs.karzoun.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# NodeInput



**Kind**: `input`

## Fields

**`_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`](/api-reference/queries/automationCatalog) for the full catalog.

---

**`automationId`**: `String`

Parent [`Automation`](/api-reference/types/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`](/api-reference/types/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`](/api-reference/mutations/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`](/api-reference/queries/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.



This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.