Documentation · Nodes

Node catalog

Prefer GET /api/v1/node-types at runtime. This page mirrors the same shared catalog for humans. Build graphs on Graphs.
GET/api/v1/node-types

List node types

Returns the shared node catalog agents should use: labels, data fields, handles, and which credential type the user must attach in the UI.

Example request

curl -X GET "https://agenticsline.com/api/v1/node-types" \
  -H "Authorization: Bearer agt_your_api_key"

Example response

{
  "items": [
    {
      "type": "HTTP_REQUEST",
      "label": "HTTP Request",
      "description": "Call an external HTTP API.",
      "category": "core",
      "isTrigger": false,
      "requiresCredentialType": null,
      "credentialNote": null,
      "handles": { "inputs": ["target-1"], "outputs": ["source-1"] },
      "dataFields": [ ... ],
      "exampleData": { ... }
    }
  ]
}

Available node types

MANUAL_TRIGGERTrigger manuallytriggerstrigger

Start the workflow manually from the UI.

No required data fields.

WEBHOOK_TRIGGERWebhook Triggertriggerstrigger

Start the workflow via an HTTP webhook.

  • method — HTTP method accepted by the webhook (default POST).
  • authType — Inbound auth required from callers (default NONE). Secrets are stored on the node.
  • bearerToken — Expected Bearer token when authType is BEARER.
  • basicUsername — Expected username when authType is BASIC.
  • basicPassword — Expected password when authType is BASIC.
  • apiKeyHeaderName — Header name for the API key when authType is API_KEY.
  • apiKeyValue — Expected API key value when authType is API_KEY.
SCHEDULE_TRIGGERSchedule Triggertriggerstrigger

Start the workflow on a cron schedule.

  • cronExpression (required) — Cron expression, e.g. 0 */6 * * *.
  • enabled — Whether the schedule is active when published.
  • misfirePolicy — What to do if a run is missed (e.g. SKIP_MISSED).
  • maxDelaySec — Optional max delay before skipping a late run.
TELEGRAM_TRIGGERTelegram Triggertriggerstrigger

Start the workflow from Telegram messages.

Requires credential type TELEGRAM_BOT — attach in the UI only.

No required data fields.

WHATSAPP_TRIGGERWhatsApp Triggertriggerstrigger

Start the workflow from WhatsApp messages via Wasender webhooks.

Requires credential type WHATSAPP — attach in the UI only.

No required data fields.

CHAT_TRIGGERChat Triggertriggerstrigger

Start the workflow from a chat interface.

No required data fields.

HTTP_REQUESTHTTP Requestcore

Call an external HTTP API.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • endpoint (required) — Request URL. Supports {{variables}}. With WordPress credential auth, relative paths like /wp-json/wp/v2/posts are resolved against the credential site URL.
  • method (required) — HTTP method.
  • queryParams — Optional query string parameters.
  • body — Optional request body (usually JSON string).
  • authType — NONE/BEARER/BASIC/API_KEY use inline fields. CREDENTIAL uses a saved credential (WordPress for now).
  • credentialProvider — Required when authType is CREDENTIAL. Only WORDPRESS is supported currently.
  • credentialId — Saved credential id when authType is CREDENTIAL. Attach in the dashboard UI — not via API.
SET_NODESet Nodetransform

Set a variable in the workflow context. With multiple incoming branches, waits for all parents before running.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • value (required) — Value to store. Supports {{variables}}.
  • valueType (required) — How to parse the value.
CODE_NODECodecore

Run sync JavaScript in a QuickJS WASM sandbox. Reads workflow context and stores the return value under variableName.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • code (required) — Sync JS body. Use global `context` for upstream data. Must return a value. No network/fs. Default 5s timeout.
  • timeoutMs — Optional interrupt deadline in milliseconds (default 5000).
FILE_NODEFiletransform

Display an image from a URL (e.g. OpenRouter/Pinata link). Custom execution panel shows preview + download.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • mode (required) — Currently only display_image. More modes later.
  • sourceUrl (required) — Image URL. Supports {{variables}} (e.g. {{openRouter1}} when OpenRouter image mode returned a Pinata URL).
OPENROUTEROpenRouterai

Generate text or an image via OpenRouter. Image mode pins to Pinata and stores the gateway URL under variableName.

Requires credential type OPENROUTER — attach in the UI only.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • outputMode — text (default) returns model text/JSON. image generates a picture, uploads to Pinata, and stores the public URL string.
  • userPrompt (required) — User / image prompt. Supports {{variables}}.
  • systemPrompt — Optional system prompt (text mode only).
  • model (required) — OpenRouter model id. For image mode use a fast image model (e.g. google/gemini-2.5-flash-image).
  • forceJsonOutput — Force JSON-shaped model output (text mode only).
AGENT_NODEAgent Nodeai

Run an autonomous agent with optional tools and memory.

Requires credential type OPENROUTER — attach in the UI only.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • userPrompt (required) — Agent user prompt. Supports {{variables}}.
  • systemPrompt — Optional system prompt.
  • model (required) — OpenRouter model id.
  • chatMode — Memory mode, e.g. MEMORY.
  • maxMemoryMessages — Max prior messages kept in memory.
  • enabledTools — Optional tool ids the agent may use.
EXTRACTOR_NODEExtractor Nodetransform

Pull one or more values from workflow context into a single object under variableName. Supports path lookup, deep key/value search, and object_where matching inside arrays.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • fields (required) — At least one extraction rule. Each item becomes a key on the output object. See field shape below.
  • fields[].outputKey (required) — Key name written into the output object (same naming rules as variableName: letters/numbers/underscore).
  • fields[].lookupMode (required) — How to find the value. path: dotted path from context. key_name: find all values for a property name (deep). key_value: find all scalar matches equal to lookupValue (deep). object_where: find first object in an array where matchKey === matchValue.
  • fields[].sourcePath — Required for path and object_where. Dotted path into context (e.g. users.0.email or httpResponse.data.items). For key_name/key_value, optional scope path (defaults to full context).
  • fields[].lookupValue — Required for key_name (property name) and key_value (value to match). Supports {{variables}} when used as a template string in the UI.
  • fields[].matchKey — Required for object_where. Property name to compare on each array item.
  • fields[].matchValue — Required for object_where. Expected value (string compare / toString for numbers/booleans). Supports {{variables}}.
  • fields[].outputType — Cast after operation. Defaults to string. Missing lookups fall back to type-specific defaults (e.g. string → "not found", number → 0, array → []).
  • fields[].operation — Transform before cast. as_is (default), first (array[0]), join (array → string), count (length). Defaults to as_is.
  • fields[].separator — Join separator when operation is join. Defaults to ", ".
CONDITION_NODECondition Nodeflow

Branch the flow. True path uses source-1; false path uses source-false.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • conditions (required) — Comparison rows. Operators: eq, ne, gt, gte, lt, lte.
  • expression — Optional legacy expression string.
SWITCH_NODE_ROUTESwitch Routeflow

Route to the first matching case handle (source-{caseId}), or source-default.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • cases (required) — Ordered cases. First match wins. Operators: eq, ne, gt, gte, lt, lte.
WAIT_FOR_RESPONSE_NODEWait for Responseflow

Pause until a matching reply (true / source-1) or timeout (false / source-false).

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • sessionKey (required) — Correlation key for the inbound chat. Telegram: {{telegramTrigger.chat.id}}. WhatsApp: {{whatsappTrigger.chatId}}.
  • timeout (required) — Max wait in seconds (5, 10, or 20).
  • timeoutUnit — Always seconds.
LOOP_NODELoop Nodetransform

Loop through a list of items.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • arrayInput (required) — Array to iterate, often a {{variable}}.
BREAK_NODEBreak nodetransform

Continue only after the loop’s last iteration.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
DELAY_NODEDelay Nodetransform

Delay before continuing to the next node.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • delay (required) — Delay in ms, or a {{variable}} resolving to ms.
TELEGRAM_MESSAGETelegram Messagecore

Send a message to a Telegram chat.

Requires credential type TELEGRAM_BOT — attach in the UI only.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • message (required) — Message text. Supports {{variables}}.
  • chatId — Optional chat id. Supports {{variables}}.
WHATSAPP_MESSAGEWhatsApp Messagecore

Send a WhatsApp text message to a person or group via Wasender.

Requires credential type WHATSAPP — attach in the UI only.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • message (required) — Message text. Supports {{variables}}.
  • to — Optional E.164 phone or group JID (@g.us). Supports {{variables}}.
INTERFACE_TEXTInterface Textinterfaces

Write to a text interface document.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • interfaceId — Target text interface id (often set in the UI).
  • content — Text content to write. Supports {{variables}}.
INTERFACE_TABLEInterface Tableinterfaces

Write to a table interface.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
  • interfaceId — Target table interface id (often set in the UI).
GOOGLE_SHEETGoogle Sheetscore

Read, append, or update a Google Sheet range.

Requires credential type GOOGLE — attach in the UI only.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
GOOGLE_SHEET_FILEGoogle Sheet filecore

Create or delete Google Sheet / Drive files.

Requires credential type GOOGLE — attach in the UI only.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
GOOGLE_DOCSGoogle Docscore

Read or update a Google Doc.

Requires credential type GOOGLE — attach in the UI only.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
GOOGLE_DOCS_FILEGoogle Doc filecore

Create or delete Google Docs.

Requires credential type GOOGLE — attach in the UI only.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
GMAIL_NODE_GET_MESSAGESGmail — Get messagescore

List messages from a connected Gmail inbox.

Requires credential type GOOGLE — attach in the UI only.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
GMAIL_NODE_SEND_MESSAGEGmail — Send emailcore

Send an email from a connected Gmail account.

Requires credential type GOOGLE — attach in the UI only.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
WORDPRESS_NODE_GET_POSTSWordPress — Postscore

Fetch posts via the WordPress REST API.

Requires credential type WORDPRESS — attach in the UI only.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
WORDPRESS_NODE_GET_PAGESWordPress — Pagescore

Fetch pages via the WordPress REST API.

Requires credential type WORDPRESS — attach in the UI only.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
WORDPRESS_NODE_CREATE_POSTWordPress — Create postcore

Create a post via the WordPress REST API.

Requires credential type WORDPRESS — attach in the UI only.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
WORDPRESS_NODE_CREATE_PAGEWordPress — Create pagecore

Create a page via the WordPress REST API.

Requires credential type WORDPRESS — attach in the UI only.

  • variableName — Context key other nodes can reference as {{variableName}}. On graph write this is also mirrored to varibleName for execution compatibility.
We use cookies
We use cookies to ensure you get the best experience on our website. For more information on how we use cookies, please see our cookie policy.

By clicking "Accept", you agree to our use of cookies.

Learn more
Node Catalog | Agentics Line