trello-plugin/docs/backend/003_manage_lists_spec.md

Trello Plugin — Manage Trello Lists

Feature: US: Manage Trello Lists Issue: #3 Branch: feature/manage-lists Doc: 003

Overview

Extends the Trello plugin with list management capabilities: create, rename, archive, and reposition lists on a Trello board.

Design Decisions

• Lists require a board context — Creating a list needs a board ID. Other operations (rename, archive, move) use the list's Trello ID which is globally unique.
• Position parameter — Uses Trello's pos field which accepts "top", "bottom", or a positive number.

Tools

trello_create_list

Create a new list on a board.

Parameters:

Param	Type	Required	Description
name	string	Yes	List name
board_id	string	Yes	Board ID or name
pos	string	No	Position: "top", "bottom", or number (default: "bottom")

Returns:

{"success": true, "list": {"id": "l1", "name": "My List", "id_board": "b1"}}

trello_rename_list

Rename an existing list.

Parameters:

Param	Type	Required	Description
list_id	string	Yes	List ID
name	string	Yes	New name

Returns:

{"success": true, "list": {"id": "l1", "name": "Renamed List"}}

trello_archive_list

Archive a list.

Parameters:

Param	Type	Required	Description
list_id	string	Yes	List ID

Returns:

{"success": true, "message": "List 'My List' archived."}

trello_move_list

Move a list to a different position.

Parameters:

Param	Type	Required	Description
list_id	string	Yes	List ID
pos	string	Yes	Position: "top", "bottom", or a number

Returns:

{"success": true, "message": "List 'My List' moved."}

Trello API Endpoints

Purpose	Method	Endpoint
Create list	POST	/1/lists
Update list (rename, archive, move)	PUT	/1/lists/{id}

Error Handling

• List not found → clear error message
• Board not found when creating → propagate board lookup error