update_column_color
Change the highlight color of a column on a Yokan Kanban board to visually organize and categorize workflow stages.
Instructions
Updates the highlight color of a specified column.
Args: board_id (int): The ID of the board containing the column. column_id (str): The ID of the column to update. color (str): The new highlight color for the column (e.g., "red", "#FF0000"). auth (AuthContext): The authentication context containing user ID and token.
Returns: yokan_models.Column: The updated column object.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| board_id | Yes | ||
| column_id | Yes | ||
| color | Yes | ||
| auth | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| tasks | No | ||
| title | Yes | ||
| minimized | No | ||
| highlightColor | No |
Implementation Reference
- src/main.py:335-364 (handler)The handler function 'update_column_color' that implements the MCP tool logic for updating a column's color. It is registered using the '@app_instance.tool' decorator and wrapped with '@error_handler'.
@app_instance.tool @error_handler async def update_column_color( board_id: int, column_id: str, color: str, auth: AuthContext, ) -> yokan_models.Column: """Updates the highlight color of a specified column. Args: board_id (int): The ID of the board containing the column. column_id (str): The ID of the column to update. color (str): The new highlight color for the column (e.g., "red", "#FF0000"). auth (AuthContext): The authentication context containing user ID and token. Returns: yokan_models.Column: The updated column object. """ board = await yokan_client.get_board(board_id=board_id, token=auth.token) if "columns" not in board.data or column_id not in board.data["columns"]: raise McpError(error=ErrorData(code=NOT_FOUND, message="Column not found")) column = board.data["columns"][column_id] column["highlightColor"] = color await yokan_client.update_board( board_id=board_id, name=board.name, data=board.data, token=auth.token ) return yokan_models.Column(**column)