View as Markdown
Mural icon

Mural ACTION

Update Sticky

Update or move an existing sticky note on a mural. Every field except the mural and widget is optional, and only the fields you set are sent, so you can reposition a note by supplying just X Position and Y Position or reword it by supplying just Text. At least one updatable field must be set. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Mural account once, then configure and run Update Sticky 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: "mural-update-sticky",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    mural: { authProvisionId: "apn_xxxxxxx" },
    workspaceId: "Workspace ID",
    muralId: "Mural ID",
  },
})

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 Sticky inputs
Property Type Description
workspaceId Workspace ID string
The ID of the Workspace.
Required Dynamic
muralId Mural ID string
The ID of the Mural.
Required Dynamic
widgetId Widget ID string
The id of a widget, as returned by the List Widgets action (e.g. 0-12345).
Required Dynamic
text Text string
The text in the widget
Optional
htmlText HTML Text string
The text in the widget with inline HTML formatting, for example <p><strong>Blocked</strong> on <em>vendor review</em></p>. Supports <strong>, <em>, <u>, <s>, <ul>, <ol>, and <li>. When set, this takes priority over Text, and these tags override the widget's bold, italic, underline, and strike style properties.
Optional
xPosition X Position integer
The horizontal position of the widget in px (e.g. 100)
Optional
yPosition Y Position integer
The vertical position of the widget in px (e.g. 100)
Optional
title Title string
The title of the widget in the outline
Optional
height Height integer
The height of the widget in px (e.g. 300)
Optional
width Width integer
The width of the widget in px (e.g. 500)
Optional
hidden Hidden boolean
If true, the widget is hidden from non-facilitators. Applies only when the widget is in the outline
Optional
tagIds Tag IDs string[]
Unique identifiers of the tags in the widget
Optional Dynamic
parentId Parent ID string
The ID of the area widget that should contain this sticky note, for example 0-12345. When set, X Position and Y Position are measured from the area's top-left corner instead of the mural's.
Optional Dynamic

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
mural-update-sticky
Version
0.0.2
App
Mural
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes