Businessmap icon

Businessmap

Use Businessmap API v2

Main Card → Move

AI-generated

Overview

The 'Move' operation of the 'Main Card' resource in the Businessmap n8n node facilitates the relocation of a card within a board, enabling users to reorganize their workflow by changing the card's position across different boards, workflows, lanes, or columns.

Use Case Examples

  1. A project manager needs to move a task card from the 'To Do' column to the 'In Progress' column within the same board to reflect its current status.
  2. A team member wants to transfer a card from one board to another to indicate that a task has been reassigned to a different project.

Properties

Name Meaning
Card ID The unique identifier of the card to be moved. This property is mandatory and must be a numeric value.
Board Name or ID Specifies the target board where the card will be moved. This can be selected from a list of available boards or entered manually as a numeric ID.
Workflow Name or ID Indicates the workflow within the target board where the card should be placed. Similar to the board, it can be selected from a list or entered as a numeric ID.
Lane Name or ID Denotes the lane within the workflow where the card will be positioned. This can be chosen from a list or specified by its numeric ID.
Column Name or ID Identifies the column within the lane where the card should be moved. Selection can be made from a list or by entering the numeric ID.
Output Determines the format of the response after the operation. Options include 'Simplified', 'Raw', or 'Selected Fields'.

Output

JSON

  • card_id - The unique identifier of the moved card.
  • board_id - The ID of the board where the card was moved.
  • workflow_id - The ID of the workflow within the board where the card was placed.
  • lane_id - The ID of the lane within the workflow where the card is located.
  • column_id - The ID of the column within the lane where the card resides.
  • position - The new position of the card within the column.
  • status - Indicates the success or failure of the move operation.

Troubleshooting

  • Ensure that all ID fields (Card ID, Board ID, Workflow ID, Lane ID, Column ID) are correctly specified and exist within the Businessmap system to prevent errors during the move operation.
  • Verify that the user has the necessary permissions to move cards within the specified board, workflow, lane, and column to avoid authorization issues.

Links

Discussion