delete-shape-item
Remove a specific shape from a Miro board by providing the board ID and shape ID to clean up visual elements.
Instructions
Delete a specific shape item from a Miro board
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| boardId | Yes | Unique identifier (ID) of the board that contains the shape | |
| itemId | Yes | Unique identifier (ID) of the shape that you want to delete |
Implementation Reference
- src/tools/deleteShapeItem.ts:13-28 (handler)The main handler function for the 'delete-shape-item' tool. It validates the boardId and itemId inputs, calls the MiroClient API to delete the shape item, and returns a success or error response.
fn: async ({ boardId, itemId }) => { try { if (!boardId) { return ServerResponse.error("Board ID is required"); } if (!itemId) { return ServerResponse.error("Item ID is required"); } await MiroClient.getApi().deleteShapeItem(boardId, itemId); return ServerResponse.text(JSON.stringify({ success: true, message: "Shape deleted successfully" }, null, 2)); } catch (error) { return ServerResponse.error(error); } } - src/tools/deleteShapeItem.ts:9-12 (schema)Zod schema defining the input parameters for the tool: boardId (string) and itemId (string).
args: { boardId: z.string().describe("Unique identifier (ID) of the board that contains the shape"), itemId: z.string().describe("Unique identifier (ID) of the shape that you want to delete") }, - src/index.ts:160-160 (registration)Registers the deleteShapeItemTool with the ToolBootstrapper instance, making the tool available in the MCP server.
.register(deleteShapeItemTool) - src/index.ts:60-60 (registration)Imports the deleteShapeItemTool definition from its module for use in registration.
import deleteShapeItemTool from './tools/deleteShapeItem.js';