delete_node

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/grab/cursor-talk-to-figma-mcp/llms.txt

Use this file to discover all available pages before exploring further.

​

Parameters

​

Response

{
  "message": "Deleted node with ID: 123:456"
}

​

Examples

​

Delete a single element

await delete_node({
  nodeId: "123:456"
});

​

Delete after checking node type

const nodeInfo = await get_node_info({ nodeId: "123:456" });

if (nodeInfo.type === "TEXT") {
  await delete_node({ nodeId: "123:456" });
}

​

Conditionally delete nodes

// Get all text nodes
const textNodes = await scan_text_nodes({ nodeId: "parent-frame-id" });

// Delete empty text nodes
for (const node of textNodes) {
  if (node.characters === "") {
    await delete_node({ nodeId: node.id });
  }
}

​

Notes

• Deletion is permanent and cannot be undone via the API
• Deleting a parent node will delete all its children
• For deleting multiple nodes, use delete_multiple_nodes for better performance
• Cannot delete the root document node or locked nodes

​

See Also

• delete_multiple_nodes - Delete multiple nodes in a single operation