Businessmap icon

Businessmap

Use Businessmap API v2

Actions48

Main Card → Get Custom Card

AI-generated

Overview

This node operation retrieves a specific custom card from the Businessmap platform using the card's unique custom card ID and the associated board ID. It is useful for scenarios where you need detailed information about a particular card within a project management or workflow board, such as fetching card details for reporting, automation, or integration purposes.

Use Case Examples

  1. Fetch a custom card by its ID to display its details in a dashboard.
  2. Retrieve a card's information to update or analyze its status in an automated workflow.

Properties

Name Meaning
Custom Card ID The unique identifier of the custom card to retrieve. This is a required string input.
Board Name or ID The identifier or name of the board where the card resides. It can be selected from a list or entered as a numeric ID.
Output Determines the format of the output data. Options include Simplified, Raw, or Selected Fields.
Select Output Fields Specifies which fields to include in the output when 'Selected Fields' output option is chosen. Users can select multiple fields such as annotations, attachments, deadlines, description, title, and many others.

Output

JSON

  • card_id - The unique identifier of the custom card.
  • board_id - The identifier of the board containing the card.
  • annotations - Annotations related to the card.
  • attachments - Files attached to the card.
  • block_reason - Reason why the card is blocked.
  • block_times - Times when the card was blocked.
  • checked_column_checklist_items - Checklist items checked in the column.
  • child_card_stats - Statistics about child cards.
  • co_owner_ids - IDs of co-owners of the card.
  • color - Color assigned to the card.
  • column_id - Identifier of the column containing the card.
  • comment_count - Number of comments on the card.
  • cover_image - Cover image of the card.
  • created_at - Creation timestamp of the card.
  • current_block_time - Current block time duration.
  • current_cycle_time - Current cycle time duration.
  • current_logged_time - Current logged time on the card.
  • custom_id - Custom identifier of the card.
  • custom_fields - Custom fields associated with the card.
  • deadline - Deadline set for the card.
  • description - Description text of the card.
  • discard_comment - Comment related to discarding the card.
  • discarded_at - Timestamp when the card was discarded.
  • finished_subtask_count - Count of finished subtasks.
  • first_end_time - First end time recorded.
  • first_request_time - First request time recorded.
  • first_start_time - First start time recorded.
  • in_current_position_since - Duration since the card has been in the current position.
  • initiative_details - Details about initiatives related to the card.
  • is_blocked - Indicates if the card is currently blocked.
  • lane_id - Identifier of the lane containing the card.
  • last_column_id - Identifier of the last column the card was in.
  • last_end_time - Last end time recorded.
  • last_lane_id - Identifier of the last lane the card was in.
  • last_modified - Timestamp of the last modification.
  • last_request_time - Last request time recorded.
  • last_start_time - Last start time recorded.
  • lead_time_per_column - Lead time spent per column.
  • linked_cards - Cards linked to this card.
  • logged_times - Logged times on the card.
  • logged_times_for_child_cards - Logged times for child cards.
  • outcome_current_values - Current values of outcomes.
  • outcomes - Outcomes related to the card.
  • owner_user_id - User ID of the card owner.
  • position - Position of the card in the board.
  • priority - Priority level of the card.
  • reason_id - Identifier for the reason associated with the card.
  • reporter - User who reported the card.
  • revision - Revision number of the card.
  • section - Section of the board the card belongs to.
  • size - Size attribute of the card.
  • stickers - Stickers applied to the card.
  • subtasks - Subtasks under the card.
  • tag_ids - Tag identifiers associated with the card.
  • title - Title of the card.
  • transitions - Transitions the card has undergone.
  • type_id - Type identifier of the card.
  • unfinished_subtask_count - Count of unfinished subtasks.
  • version_id - Version identifier of the card.
  • watcher_ids - IDs of users watching the card.
  • workflow_id - Workflow identifier associated with the card.

Dependencies

  • an API key credential for Businessmap

Troubleshooting

  • Ensure the Custom Card ID and Board ID are correctly provided and valid numeric values where required.
  • If the node returns an error about authentication, verify that the API key credential for Businessmap is correctly configured and has the necessary permissions.
  • If the output is empty or missing expected fields, check that the selected output fields are available for the specified card and that the card exists in the given board.

Discussion