Businessmap icon

Businessmap

Use Businessmap API v2

Actions48

Card → Block

AI-generated

Overview

The 'Block' operation of the 'Card' resource in the Businessmap n8n node is designed to block a specific card on a board. This operation is particularly useful in project management scenarios where certain tasks or cards need to be temporarily halted due to dependencies, resource constraints, or other blockers. For example, if a card represents a task that cannot proceed until a prerequisite is completed, blocking the card ensures that the workflow accurately reflects the current status and prevents further actions on the blocked card until the issue is resolved.

Use Case Examples

  1. A project manager needs to pause a task because a critical resource is unavailable, so they block the corresponding card to indicate the delay.
  2. In a kanban board, a card representing a task is blocked due to a dependency on another task, and the 'Block' operation is used to prevent further progress on the card until the dependency is addressed.

Properties

Name Meaning
Board Name or ID Specifies the board containing the card to be blocked. This can be selected by ID, chosen from a list, or determined using AI assistance.
Block Reason Name or ID Indicates the reason for blocking the card. This can be selected by ID, chosen from a list, or determined using AI assistance.
Card ID The unique identifier of the card to be blocked.
Comment An optional comment providing additional context or details about the block.
Output Determines the format of the output data. Options include 'Simplified', 'Raw', or 'Selected Fields'.
Select Output Fields Allows selection of specific fields to include in the output, such as 'Annotations', 'Archived At', 'Attachments', etc.

Output

JSON

  • card_id - The unique identifier of the blocked card.
  • block_reason - The reason provided for blocking the card.
  • blocked_at - Timestamp indicating when the card was blocked.
  • comment - Any additional comments provided during the blocking process.

Troubleshooting

  • Ensure that the 'Board Name or ID' and 'Block Reason Name or ID' are correctly specified to avoid errors during execution.
  • Verify that the 'Card ID' corresponds to an existing card on the specified board to prevent invalid operations.
  • If the 'Output' field is set to 'Selected Fields', ensure that the 'Select Output Fields' parameter includes valid field names to avoid incomplete or erroneous outputs.

Links

Discussion