delete_card
Remove a task permanently from a Focalboard workspace by specifying the card and board IDs.
Instructions
Delete a card (task) from a board permanently.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cardId | Yes | The ID of the card to delete | |
| boardId | Yes | The ID of the board the card belongs to |
Implementation Reference
- src/focalboard-client.ts:270-275 (handler)Core implementation of deleteCard method that sends DELETE request to the Focalboard API to remove the specified card block.async deleteCard(boardId: string, cardId: string): Promise<void> { await this.makeRequest<void>( `/boards/${boardId}/blocks/${cardId}`, 'DELETE' ); }
- src/index.ts:437-453 (handler)MCP tool execution handler for 'delete_card' that validates inputs and delegates to FocalboardClient.deleteCard.case 'delete_card': { const cardId = args?.cardId as string; const boardId = args?.boardId as string; if (!cardId || !boardId) { throw new Error('cardId and boardId are required'); } await focalboard.deleteCard(boardId, cardId); return { content: [ { type: 'text', text: JSON.stringify({ success: true, message: 'Card deleted successfully' }) } ] };
- src/index.ts:180-195 (registration)Registration of the 'delete_card' tool including its name, description, and input schema.name: 'delete_card', description: 'Delete a card (task) from a board permanently.', inputSchema: { type: 'object', properties: { cardId: { type: 'string', description: 'The ID of the card to delete' }, boardId: { type: 'string', description: 'The ID of the board the card belongs to' } }, required: ['cardId', 'boardId'] }