Businessmap icon

Businessmap

Use Businessmap API v2

Actions48

Card → Create Subtask

AI-generated

Overview

The 'Create Subtask' operation within the 'Card' resource allows users to add a subtask to an existing card in the Businessmap application. This functionality is particularly useful for project management scenarios where tasks need to be broken down into smaller, manageable components. For example, if a project card represents a software development task, creating subtasks can help assign specific coding, testing, and documentation responsibilities to team members.

Use Case Examples

  1. A project manager needs to assign specific tasks to different team members within a project card.
  2. A team leader wants to break down a complex task into smaller, actionable items for better tracking and management.

Properties

Name Meaning
Card ID The unique identifier of the card to which the subtask will be added. This ensures the subtask is associated with the correct card.
Board Name or ID Specifies the board where the card resides. This can be selected by name or entered as an ID, ensuring the subtask is added to the correct board.
Description A textual description of the subtask, detailing the task to be performed. This provides clarity on the subtask's objective.
Deadline The due date for the subtask, helping in scheduling and tracking its completion.
Owner Name or ID Assigns the subtask to a specific user by their name or ID, indicating responsibility.
Subtask Status Indicates whether the subtask is completed or not, aiding in progress tracking.

Output

JSON

  • subtask_id - The unique identifier of the newly created subtask.
  • status - The current status of the subtask, indicating whether it's completed or pending.
  • message - A confirmation message indicating the success or failure of the subtask creation.

Dependencies

  • Businessmap API access
  • User authentication credentials

Troubleshooting

  • Ensure the 'Card ID' and 'Board Name or ID' are correct and correspond to existing entities in the Businessmap application.
  • Verify that the 'Owner Name or ID' matches an existing user to assign the subtask appropriately.
  • Check that the 'Deadline' is set in the correct format (yyyy-MM-dd) to avoid parsing errors.

Links

Discussion