# Trello

Manage Trello: boards, lists, cards, checklists, labels, members, comments. Exposes **45 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `trello_get_member` | Get a Trello member profile - GET /members/{id}. |
| `trello_list_boards` | List boards for a member - GET /members/{id}/boards. |
| `trello_get_board` | Get a board - GET /boards/{id}. |
| `trello_create_board` | Create a board - POST /boards. |
| `trello_update_board` | Update a board - PUT /boards/{id}. |
| `trello_delete_board` | Delete a board - DELETE /boards/{id}. |
| `trello_list_lists` | List all lists on a board - GET /boards/{id}/lists. |
| `trello_get_list` | Get a list - GET /lists/{id}. |
| `trello_create_list` | Create a list - POST /lists. |
| `trello_update_list` | Update a list - PUT /lists/{id}. |
| `trello_archive_list` | Archive a list - PUT /lists/{id}/closed. |
| `trello_list_cards` | List cards in a list - GET /lists/{id}/cards. |
| `trello_get_card` | Get a card - GET /cards/{id}. |
| `trello_create_card` | Create a card - POST /cards. |
| `trello_update_card` | Update a card - PUT /cards/{id}. |
| `trello_delete_card` | Delete a card - DELETE /cards/{id}. |
| `trello_list_card_members` | List members assigned to a card - GET /cards/{id}/members. |
| `trello_add_card_member` | Add a member to a card - POST /cards/{id}/members. |
| `trello_remove_card_member` | Remove a member from a card - DELETE /cards/{id}/members/{idMember}. |
| `trello_list_checklists` | List checklists on a card - GET /cards/{id}/checklists. |
| `trello_create_checklist` | Create a checklist on a card - POST /checklists. |
| `trello_delete_checklist` | Delete a checklist - DELETE /checklists/{id}. |
| `trello_list_checkitems` | List items in a checklist - GET /checklists/{id}/checkItems. |
| `trello_create_checkitem` | Create a checkitem - POST /checklists/{id}/checkItems. |
| `trello_update_checkitem` | Update a checkitem - PUT /checklists/{id}/checkItems/{checkItemId}. |
| `trello_delete_checkitem` | Delete a checkitem - DELETE /checklists/{id}/checkItems/{checkItemId}. |
| `trello_list_labels` | List labels on a board - GET /boards/{id}/labels. |
| `trello_create_label` | Create a label - POST /labels. |
| `trello_update_label` | Update a label - PUT /labels/{id}. |
| `trello_delete_label` | Delete a label - DELETE /labels/{id}. |
| `trello_add_card_label` | Add a label to a card - POST /cards/{id}/idLabels. |
| `trello_remove_card_label` | Remove a label from a card - DELETE /cards/{id}/idLabels/{idLabel}. |
| `trello_list_comments` | List comments on a card - GET /cards/{id}/actions?filter=commentCard. |
| `trello_create_comment` | Create a comment on a card - POST /cards/{id}/actions/comments. |
| `trello_delete_comment` | Delete a comment - DELETE /cards/{idCard}/actions/{id}. |
| `trello_list_attachments` | List attachments on a card - GET /cards/{id}/attachments. |
| `trello_get_attachment` | Get an attachment - GET /cards/{idCard}/attachments/{id}. |
| `trello_create_attachment` | Attach a URL to a card - POST /cards/{id}/attachments. |
| `trello_delete_attachment` | Delete an attachment - DELETE /cards/{idCard}/attachments/{id}. |
| `trello_list_board_members` | List members on a board - GET /boards/{id}/members. |
| `trello_add_board_member` | Add a member to a board - POST /boards/{id}/members. |
| `trello_remove_board_member` | Remove a member from a board - DELETE /boards/{id}/members/{idMember}. |
| `trello_list_organizations` | List organizations for a member - GET /members/{id}/organizations. |
| `trello_get_organization` | Get an organization - GET /organizations/{id}. |
| `trello_search` | Search cards, boards, members, orgs - GET /search. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`TRELLO_API_KEY`** - Trello - create a Power-Up then copy the API key. (https://trello.com/power-ups/admin)
- **`TRELLO_TOKEN`** - Click 'Token' next to your API key to generate a user token.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `TRELLO_API_KEY` | Trello - create a Power-Up then copy the API key. |
| `TRELLO_TOKEN` | Click 'Token' next to your API key to generate a user token. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope - regenerate it.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Trello API documentation](https://developer.atlassian.com/cloud/trello/rest/)