delete_node

Auto-generate your docs

Permanently remove a single node from the Figma document. Use this for removing individual elements.

Parameters

string

required

The ID of the node to delete

Response

Returns a confirmation message with the deleted node’s ID.

{
  "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

Document & Selection

Creating Elements

Text Operations

Styling

Layout & Organization

Auto Layout

Components & Styles

Annotations

Prototyping & Connections

Export

Connection Management

AI Prompts

Parameters

Response

Examples

Delete a single element

Delete after checking node type

Conditionally delete nodes

Notes

See Also

​Parameters

​Response

​Examples

​Delete a single element

​Delete after checking node type

​Conditionally delete nodes

​Notes

​See Also

Parameters

Response

Examples

Delete a single element

Delete after checking node type

Conditionally delete nodes

Notes

See Also