basecamp_move_kanban_card
Move a kanban card to a different column or reposition it within a column to organize project workflows in Basecamp.
Instructions
Move a kanban card to a different column and/or position within that column.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bucket_id | Yes | Basecamp resource identifier | |
| card_id | Yes | ||
| column_id | Yes | ||
| position | No | Position within the destination column (zero-indexed). If not specified, card will be added to the end of the column. |
Implementation Reference
- src/tools/kanban.ts:677-711 (handler)Handler function that executes the logic to move a kanban card to a new column and optional position using the Basecamp API client.async (params) => { try { const client = await initializeBasecampClient(); const response = await client.cardTableCards.move({ params: { bucketId: params.bucket_id, cardId: params.card_id }, body: { column_id: params.column_id, ...(params.position !== undefined ? { position: params.position } : {}), }, }); if (response.status !== 204) { throw new Error("Failed to move card"); } return { content: [ { type: "text", text: `Card moved successfully to column ${params.column_id}${ params.position !== undefined ? ` at position ${params.position}` : "" }!`, }, ], }; } catch (error) { return { content: [{ type: "text", text: handleBasecampError(error) }], }; } },
- src/tools/kanban.ts:653-676 (schema)Input schema and metadata (title, description, annotations) for the basecamp_move_kanban_card tool.{ title: "Move Kanban Card", description: "Move a kanban card to a different column and/or position within that column.", inputSchema: { bucket_id: BasecampIdSchema, card_id: BasecampIdSchema, column_id: BasecampIdSchema, position: z .number() .int() .nonnegative() .optional() .describe( "Position within the destination column (zero-indexed). If not specified, card will be added to the end of the column.", ), }, annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true, }, },
- src/tools/kanban.ts:651-712 (registration)Registration of the basecamp_move_kanban_card tool in the registerKanbanTools function, including name, schema, and handler.server.registerTool( "basecamp_move_kanban_card", { title: "Move Kanban Card", description: "Move a kanban card to a different column and/or position within that column.", inputSchema: { bucket_id: BasecampIdSchema, card_id: BasecampIdSchema, column_id: BasecampIdSchema, position: z .number() .int() .nonnegative() .optional() .describe( "Position within the destination column (zero-indexed). If not specified, card will be added to the end of the column.", ), }, annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true, }, }, async (params) => { try { const client = await initializeBasecampClient(); const response = await client.cardTableCards.move({ params: { bucketId: params.bucket_id, cardId: params.card_id }, body: { column_id: params.column_id, ...(params.position !== undefined ? { position: params.position } : {}), }, }); if (response.status !== 204) { throw new Error("Failed to move card"); } return { content: [ { type: "text", text: `Card moved successfully to column ${params.column_id}${ params.position !== undefined ? ` at position ${params.position}` : "" }!`, }, ], }; } catch (error) { return { content: [{ type: "text", text: handleBasecampError(error) }], }; } }, );