View as Markdown
WorkFlowy icon

WorkFlowy ACTION

Update Node

Updates an existing WorkFlowy node's name, note, and/or layout mode (POST /api/v1/nodes/:id). Run Search Nodes first to obtain the target node ID. At least one of name, note, or layout mode must be provided. Note that the update endpoint only returns a status, not the full updated node. See the documentation.
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's WorkFlowy account once, then configure and run Update Node from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "workflowy-update-node",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    workflowy: { authProvisionId: "apn_xxxxxxx" },
    nodeId: "Node ID",
    name: "Name",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Update Node inputs
Property Type Description
nodeId Node ID string
The ID of the node to update. Run Search Nodes to find a valid node ID.
Required
name Name string
New main text for the node. Provide at least one of name, note, or layout mode.
Optional
note Note string
New note (secondary text) for the node. Provide at least one of name, note, or layout mode.
Optional
layoutMode Layout Mode string
Optional display mode for the node. One of: bullets, todo, h1, h2, h3, code-block, quote-block.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
workflowy-update-node
Version
0.0.2
App
WorkFlowy
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes