duplicateWhiteboardElements
Copy-paste existing whiteboard elements — the MCP equivalent of selecting a group and pressing Ctrl/Cmd+D. Clones the given elements (plus their group peers + bound text/labels) with FRESH ids, offsets the copy by dx/dy, and by default groups it into ONE new unit so it moves together. Use it to b...
This record as markdown: /tools/io-stablebaseline-sb/duplicatewhiteboardelements.md
What duplicateWhiteboardElements does on Stable Baseline
AI agents use duplicateWhiteboardElements to create or update resources in Stable Baseline, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Stable Baseline environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
dx | number | — | Horizontal offset for the copy (default 40). Use the element width + a gap to place copies side by side. |
dy | number | — | Vertical offset for the copy (default 40). |
ids | array | — | Element ids to copy. Each id's full group + any bound text are auto-included. Use this and/or groupId. |
group | boolean | — | Group the copy into one new unit so it moves/duplicates together (default true). |
groupId | string | — | Copy EVERY element in this group as one unit — e.g. a placed stencil's `groupId` returned by addWhiteboardElements. |
documentId | string | Yes | The whiteboard's documentId. |
includeGroupPeers | boolean | — | Auto-include the full group of any id you pass (default true). |
Parameters from the server's own tool schema.
Why duplicateWhiteboardElements is rated Medium
This tool creates new whiteboard elements by duplicating existing ones — a reversible write/create operation. It does not execute code, delete data, or involve financial transactions. The blast radius is medium since misuse could clutter or corrupt a shared whiteboard, but changes are reversible.
From the tool's definition Clones the given elements (plus their group peers + bound text/labels) with FRESH ids, offsets the copy by dx/dy, and by default groups it into ONE new unit
Attacks that exploit this kind of access
The rule that runs duplicateWhiteboardElements safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Stable Baseline, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For duplicateWhiteboardElements, this is the rule to start with:
duplicateWhiteboardElements stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Stable Baseline, apply this rule, and every duplicateWhiteboardElements call is checked against it from then on.
Questions about duplicateWhiteboardElements
Copy-paste existing whiteboard elements — the MCP equivalent of selecting a group and pressing Ctrl/Cmd+D. Clones the given elements (plus their group peers + bound text/labels) with FRESH ids, offsets the copy by dx/dy, and by default groups it into ONE new unit so it moves together. Use it to build something once (a labelled stencil frame, a kanban card, a UML class) then stamp out consistent repeats fast — then retext/recolour each copy by its new id (via the returned idMap) with updateWhiteboardScene. Pass groupId to copy a whole group as a unit (e.g. a placed stencil's groupId from its placement result) and/or ids for specific elements. Internal references (group membership, bound text containerId, arrow start/end bindings) are remapped within the copied set; a binding to an element you did NOT copy is dropped. Returns { duplicated, idMap (old id → new id), groupId (the copy's new unit group), elementCount }. Render with getWhiteboardImage afterwards to verify. It is categorised as a Write tool in the Stable Baseline MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
duplicateWhiteboardElements accepts 7 parameters: dx, dy, ids, group, groupId, documentId, includeGroupPeers. Required: documentId. The full parameter table on this page comes from the server's own tool schema.
Register the Stable Baseline MCP server in PolicyLayer and add a rule for duplicateWhiteboardElements: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Stable Baseline. Nothing to install.
duplicateWhiteboardElements is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the duplicateWhiteboardElements rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for duplicateWhiteboardElements. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
duplicateWhiteboardElements is provided by the Stable Baseline MCP server (https://api.stablebaseline.io/functions/v1/cloud-serve/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Stable Baseline, and thousands of servers like it.
This server
Across the catalogue