# Trello on boxd

> A web-based, kanban-style, list-making application.

- Page: https://boxd.sh/integrations/trello/
- CLI: `run trello` (329 commands, 10 marked common)
- SDK: `import { trello } from "@boxd/run"`; every parameter and response type is at `@boxd/run/trello`
- Triggers: 5
- Connect: `run auth trello` (Sign in with Trello), or https://app.boxd.sh/integrations/detail/trello
- All integrations: https://boxd.sh/integrations/ (Markdown: https://boxd.sh/integrations/index.md)

## From the shell

```sh
run auth trello      # once: prints a link to connect your account
run trello           # list its commands
run trello get-members-me
```

Parameters are flags (`--flag value`); object and array parameters take a JSON string. Output is YAML, or JSON with `--json`. Calls use your own connection; `--scope <name>` uses a connection shared with your team.

## From a script

```ts
import { trello } from "@boxd/run";

const result = await trello.getMembersMe({});
console.log(result);

trello.on("new-activity", async (event) => {
  // New Activity Trigger: runs on this machine, once per event
  console.log(event);
});
```

Run it with `run trello.run.ts`. A script that calls `.on()` keeps running as a job and handles each event.

## Commands

Required flags are listed; `run trello <command> --help` lists the optional ones. "common" marks what `run trello` shows without `--all`.

| Command | SDK method | Required flags | Optional | Description |
|---|---|---|---|---|
| `add-boards` ·common | `trello.addBoards()` | — | 31 | Creates a new Trello board; the 'name' parameter is required for creation, and various preferences can be customized or cloned from a source board |
| `add-boards-lists-by-id-board` ·deprecated | `trello.addBoardsListsByIdBoard()` | `--idBoard` `--name` | 1 | Use TRELLO_LIST_CREATE_LIST instead |
| `add-card-vote` | `trello.addCardVote()` | `--idCard` `--value` | 0 | Casts a 'yes' vote for a specified member on a Trello card; a member can only vote once per card |
| `add-cards` ·common | `trello.addCards()` | `--idList` | 14 | Creates a new card in a Trello list |
| `add-cards-actions-comments-by-id-card` | `trello.addCardsActionsCommentsByIdCard()` | `--idCard` `--text` | 0 | Adds a new text comment, which can include @mentions, to a Trello card specified by its ID; file attachments are not supported via this action |
| `add-cards-attachments-by-id-card` | `trello.addCardsAttachmentsByIdCard()` | `--idCard` | 4 | Adds an attachment to a Trello card by `idCard`; specify either a `file` to upload or a `url` to link, but not both |
| `add-cards-checklists-by-id-card` | `trello.addCardsChecklistsByIdCard()` | `--idCard` | 3 | Adds a checklist to a Trello card: use `value` to add a specific existing checklist, `idChecklistSource` to create a new checklist by copying an existing one (optionally using `name` for the new… |
| `add-cards-id-labels-by-id-card` | `trello.addCardsIdLabelsByIdCard()` | `--idCard` `--value` | 0 | Adds an existing label to a Trello card; `idCard` identifies the card and `value` is the ID of the label to add |
| `add-checklist-item` ·deprecated | `trello.addChecklistItem()` | `--idCard` `--idChecklist` `--name` `--pos` | 0 | Use add-checklists-check-items-by-id-checklist instead |
| `add-checklists` | `trello.addChecklists()` | — | 5 | Creates a new checklist on a Trello card, either by name or by copying from `idChecklistSource`, targeting an `idCard` or `idBoard`; this action creates only the checklist structure, not its items |
| `add-checklists-check-items-by-id-checklist` | `trello.addChecklistsCheckItemsByIdChecklist()` | `--idChecklist` | 3 | Adds a new check item to a specified Trello checklist; this action does not update existing check items |
| `add-labels` | `trello.addLabels()` | — | 3 | Creates a new label with a specified name (required) and color on a Trello board (idBoard required); this action defines the label but does not apply it to cards |
| `add-lists` ·common | `trello.addLists()` | — | 6 | Creates a new list on a specified Trello board, with options to copy an existing list, set its position, initial state (archived/subscribed), and does not modify existing lists or move cards |
| `add-lists-cards-by-id-list` ·deprecated | `trello.addListsCardsByIdList()` | `--idList` `--name` | 4 | Use TRELLO_CARD_CREATE_AND_UPDATE instead |
| `add-member-to-card` | `trello.addMemberToCard()` | `--idCard` | 1 | Assigns a Trello member to a specific Trello card by card ID (or short link) and member ID |
| `archive-all-list-cards` | `trello.archiveAllListCards()` | `--idList` | 0 | Archives all cards in a Trello list; while cards can be restored via the Trello interface, this action does not provide an unarchive function |
| `convert-checklist-item-to-card` | `trello.convertChecklistItemToCard()` | `--idCard` `--idCheckItem` `--idChecklist` | 0 | Converts a checklist item into a new card (useful for promoting a subtask), which inherits some properties from the item; this is irreversible via the API and offers no customization during conversion |
| `create-action-reaction` | `trello.createActionReaction()` | `--idAction` | 4 | Add a new emoji reaction to a Trello action |
| `create-board-label` | `trello.createBoardLabel()` | `--idBoard` | 2 | Creates a new label on an existing Trello board |
| `create-card-label` | `trello.createCardLabel()` | `--idCard` | 3 | Adds a label to an existing Trello card (specified by `idCard`), defining the label by `name` and either `color` or the overriding `value` (which specifies color by name); a new label is created on… |
| `create-card-sticker` | `trello.createCardSticker()` | `--idCard` | 5 | Adds a sticker to a Trello card, using a default sticker name (e.g., 'taco-cool') or a custom sticker ID for the image, and allows specifying its position, rotation, and z-index |
| `create-member-board-background` | `trello.createMemberBoardBackground()` | `--idMember` | 3 | Adds a new custom board background, from an image file, to a specified Trello member's collection, making it available for their use but not applying it to any board |
| `create-member-board-star` | `trello.createMemberBoardStar()` | `--idBoard` `--idMember` `--pos` | 0 | Stars a Trello board for a member (does not remove or list stars), optionally at a specified position; the board must exist and be accessible to the member |
| `create-member-custom-board-background` | `trello.createMemberCustomBoardBackground()` | `--idMember` | 4 | Adds a new custom board background for a specified Trello member; either a `file` (image upload) or a `url` (external image URL) must be provided |
| `create-member-custom-emoji` | `trello.createMemberCustomEmoji()` | `--idMember` | 2 | Adds a new custom emoji using an image file and a unique name to a Trello member's account; this emoji is member-specific and not shared across the workspace |
| `create-member-custom-sticker` | `trello.createMemberCustomSticker()` | `--file` `--idMember` | 0 | Uploads a custom sticker to a Trello member's collection, if the member's plan allows custom stickers and respects associated limits |
| `create-member-saved-search` | `trello.createMemberSavedSearch()` | `--idMember` `--name` `--pos` `--query` | 0 | Creates a new saved search with a specified name, position, and query for a Trello member |
| `create-organization` | `trello.createOrganization()` | — | 12 | Creates a new Trello organization (Workspace) with a `displayName` (required), and optionally a description, website, and various preferences (e.g., board visibility, member invitation restrictions) |
| `create-session` | `trello.createSession()` | — | 2 | Creates or updates a Trello user session, optionally linking it to a specific board for status updates and setting the user's activity status |
| `create-webhook` | `trello.createWebhook()` | `--callbackURL` `--idModel` | 2 | Create a new Trello webhook for monitoring changes to a board, card, list, or member |
| `delete-action` | `trello.deleteAction()` | `--idAction` | 0 | Deletes a specific Trello action, such as a `commentCard`, by its ID; this is an irreversible operation and only applies to deletable action types, as many (especially system-generated) actions… |
| `delete-action-reaction` | `trello.deleteActionReaction()` | `--id` `--idAction` | 0 | Permanently deletes a specified reaction from a Trello action |
| `delete-board` | `trello.deleteBoard()` | `--id` | 0 | Permanently deletes a Trello board by its ID |
| `delete-card-attachment` | `trello.deleteCardAttachment()` | `--idAttachment` `--idCard` | 0 | Permanently removes a specified attachment from a Trello card; this action is irreversible and requires that both the card and the attachment exist |
| `delete-card-checklist` | `trello.deleteCardChecklist()` | `--idCard` `--idChecklist` | 0 | Permanently deletes a specific checklist from a Trello card |
| `delete-card-comment` | `trello.deleteCardComment()` | `--idAction` `--idCard` | 0 | Deletes a specific comment action (identified by `idAction`) from a Trello card (identified by `idCard`); this operation is irreversible and only affects comments |
| `delete-cards-by-id-card` ·common | `trello.deleteCardsByIdCard()` | `--idCard` | 0 | Permanently deletes an archived Trello card specified by its `idCard` |
| `delete-cards-members-voted-by-id-card-by-id-member` | `trello.deleteCardsMembersVotedByIdCardByIdMember()` | `--idCard` `--idMember` | 0 | Removes a member's vote from a Trello card |
| `delete-cards-stickers-by-id-card-by-id-sticker` | `trello.deleteCardsStickersByIdCardByIdSticker()` | `--idCard` `--idSticker` | 0 | Permanently removes a specific sticker (identified by `idSticker`) from a Trello card (identified by `idCard`) |
| `delete-checklist-item` | `trello.deleteChecklistItem()` | `--idCheckItem` `--idChecklist` | 0 | Permanently deletes a specific check item from a checklist on a Trello card; this operation is irreversible and only affects the specified item, not the entire checklist |
| `delete-checklists-by-id-checklist` | `trello.deleteChecklistsByIdChecklist()` | `--idChecklist` | 0 | Permanently and irreversibly deletes a Trello checklist and all its items using the `idChecklist` |
| `delete-labels-by-id-label` | `trello.deleteLabelsByIdLabel()` | `--idLabel` | 0 | Permanently deletes an existing label from a Trello board by its ID; this operation is irreversible via the API |
| `delete-member-board-background` | `trello.deleteMemberBoardBackground()` | `--idBoardBackground` `--idMember` | 0 | Permanently deletes a specific custom board background belonging to the specified Trello member; this operation cannot be undone |
| `delete-member-custom-sticker` | `trello.deleteMemberCustomSticker()` | `--idCustomSticker` `--idMember` | 0 | Deletes a custom sticker from a Trello member's collection; this permanent action is only available for custom stickers within a Trello Workspace on a paid plan |
| `delete-member-saved-search` | `trello.deleteMemberSavedSearch()` | `--idMember` `--idSavedSearch` | 0 | Permanently deletes a specific saved search for a Trello member, used when the search is outdated or no longer needed |
| `delete-org-associated-domain` | `trello.deleteOrgAssociatedDomain()` | `--idOrg` | 0 | Irreversibly deletes an associated email domain from a Trello organization's preferences to update email domain restrictions for workspace membership; the domain must be currently associated for… |
| `delete-org-invite-restrict` | `trello.deleteOrgInviteRestrict()` | `--idOrg` `--value` | 0 | Removes a previously set email address invitation restriction from a Trello organization |
| `delete-organizations-by-id-org` | `trello.deleteOrganizationsByIdOrg()` | `--idOrg` | 0 | Permanently deletes a Trello organization and all its associated data; this action is irreversible and requires caution |
| `delete-organizations-logo-by-id-org` | `trello.deleteOrganizationsLogoByIdOrg()` | `--idOrg` | 0 | Deletes an existing Trello organization's custom logo, restoring its default and leaving other settings unchanged; if no custom logo exists, it succeeds without effect |
| `delete-organizations-members-by-id-org-by-id-member` | `trello.deleteOrganizationsMembersByIdOrgByIdMember()` | `--idMember` `--idOrg` | 0 | Permanently removes a member from a Trello organization by ID, revoking all access to its content; re-invitation is required for renewed access, and this does not delete the member's Trello account |
| `delete-tokens-by-token` | `trello.deleteTokensByToken()` | — | 1 | Deletes a specific Trello API token, identified by its value in the path, permanently revoking its access; this action is irreversible and used to invalidate compromised or unneeded tokens |
| `delete-tokens-webhooks-by-token-by-id-webhook` | `trello.deleteTokensWebhooksByTokenByIdWebhook()` | `--idWebhook` | 0 | Deletes an existing webhook, specified by its `idWebhook`, thereby stopping its notifications |
| `delete-webhooks-by-id-webhook` | `trello.deleteWebhooksByIdWebhook()` | `--idWebhook` | 0 | Permanently deletes an existing Trello webhook by its `idWebhook`, an irreversible action that stops future notifications |
| `disable-board-power-up` | `trello.disableBoardPowerUp()` | `--idBoard` `--powerUp` | 0 | Disables a Power-Up on a Trello board using the board's ID and the plugin ID of a Power-Up currently enabled on that board; this action is irreversible and may result in data loss |
| `dismiss-member-message` | `trello.dismissMemberMessage()` | `--idMember` `--value` | 0 | Dismisses a one-time message for a Trello member, adding it to their dismissed messages list |
| `enable-board-power-up` | `trello.enableBoardPowerUp()` | `--idBoard` | 1 | Enables the Power-Up specified by the 'value' parameter on the board; processes one Power-Up enablement per call |
| `generate-board-calendar-key` | `trello.generateBoardCalendarKey()` | `--idBoard` | 0 | Generates a new calendar key for the Trello board specified by `idBoard`, invalidating any previous key for that board |
| `generate-board-email-key` | `trello.generateBoardEmailKey()` | `--idBoard` | 0 | Generates a new email key for the Trello board specified by idBoard to enable or reset adding cards via email; this invalidates any previously existing email key for the board |
| `get-actions-board-by-id-action` | `trello.getActionsBoardByIdAction()` | `--idAction` | 1 | Retrieves details for the Trello board associated with a specific action ID, returning board information only |
| `get-actions-board-by-id-action-by-field` | `trello.getActionsBoardByIdActionByField()` | `--field` `--idAction` | 0 | Retrieves a specified `field` from the Trello board associated with the provided Trello `idAction` |
| `get-actions-by-id-action` | `trello.getActionsByIdAction()` | `--idAction` | 7 | Retrieves detailed information about a specific Trello action by its ID |
| `get-actions-by-id-action-by-field` | `trello.getActionsByIdActionByField()` | `--field` `--idAction` | 0 | Retrieves the value of a specific field (e.g., 'data', 'date', 'type') from a Trello action using its unique ID |
| `get-actions-card-by-id-action` | `trello.getActionsCardByIdAction()` | `--idAction` | 1 | Retrieves Trello card details for a given `idAction`, which must be an action specifically linked to a card; returns only card data, not action details |
| `get-actions-card-by-id-action-by-field` | `trello.getActionsCardByIdActionByField()` | `--field` `--idAction` | 0 | Retrieves a specific field from the Trello card associated with the given action ID |
| `get-actions-display-by-id-action` | `trello.getActionsDisplayByIdAction()` | `--idAction` | 0 | Retrieves a display-friendly representation of an existing and accessible Trello action for UI/report purposes, providing presentation-focused data instead of full raw details and without altering… |
| `get-actions-entities-by-id-action` | `trello.getActionsEntitiesByIdAction()` | `--idAction` | 0 | Retrieves all entities (e.g., boards, lists, cards, members) associated with a specific, existing Trello action ID |
| `get-actions-list-by-id-action` | `trello.getActionsListByIdAction()` | `--idAction` | 1 | Retrieves the Trello list associated with a specific Trello action ID, for actions linked to a list |
| `get-actions-list-by-id-action-by-field` | `trello.getActionsListByIdActionByField()` | `--field` `--idAction` | 0 | Retrieves a specific field of the list associated with a Trello action, returning only that single field's value |
| `get-actions-member-by-id-action` | `trello.getActionsMemberByIdAction()` | `--idAction` | 1 | Retrieves the Trello member who was the subject of an action (not the creator) |
| `get-actions-member-by-id-action-by-field` | `trello.getActionsMemberByIdActionByField()` | `--field` `--idAction` | 0 | Retrieves a specific field of the member who was the subject of a Trello action |
| `get-actions-member-creator-by-id-action` | `trello.getActionsMemberCreatorByIdAction()` | `--idAction` | 1 | Retrieves details about the Trello member who created the action with the given `idAction` |
| `get-actions-member-creator-by-id-action-by-field` | `trello.getActionsMemberCreatorByIdActionByField()` | `--field` `--idAction` | 0 | Retrieves a specific field from the profile of the Trello member who created a given action |
| `get-actions-organization-by-id-action` | `trello.getActionsOrganizationByIdAction()` | `--idAction` | 1 | Fetches the organization details for a given Trello action, if the action has an associated organization |
| `get-actions-organization-by-id-action-by-field` | `trello.getActionsOrganizationByIdActionByField()` | `--field` `--idAction` | 0 | Retrieves the value of a specific `field` for the organization associated with a Trello `idAction`; use if the action has an organization and you need only that field (e.g., 'name', 'id', 'url') |
| `get-actions-reactions-by-id` | `trello.getActionsReactionsById()` | `--id` `--idAction` | 2 | Retrieves detailed information about a specific reaction on a Trello action |
| `get-actions-reactions-by-id-action` | `trello.getActionsReactionsByIdAction()` | `--idAction` | 2 | List reactions for a specific action |
| `get-batch` | `trello.getBatch()` | `--urls` | 0 | Executes multiple Trello API GET requests in a single batch operation for efficient bulk data retrieval |
| `get-boards-actions-by-id-board` | `trello.getBoardsActionsByIdBoard()` | `--idBoard` | 14 | Retrieves actions (e.g., card creations, comments) for a Trello board by its ID, useful for activity tracking; the board must exist |
| `get-boards-board-plugins-by-id` | `trello.getBoardsBoardPluginsById()` | `--id` | 0 | Get the list of enabled Power-Ups on a Trello board |
| `get-boards-board-stars-by-id-board` | `trello.getBoardsBoardStarsByIdBoard()` | `--idBoard` | 1 | Retrieves board stars (user-marked favorites) for a specified Trello board, where `idBoard` must be an existing board; use to list a user's starred boards or all stars on a particular board |
| `get-boards-by-id-board` ·common | `trello.getBoardsByIdBoard()` | `--idBoard` | 37 | Fetches comprehensive details for a specific Trello board by its ID; this is a read-only action |
| `get-boards-by-id-board-by-field` | `trello.getBoardsByIdBoardByField()` | `--field` `--idBoard` | 0 | Retrieves the value of a single, specified field from a Trello board |
| `get-boards-cards-by-id-board` ·common | `trello.getBoardsCardsByIdBoard()` | `--idBoard` | 13 | Retrieves cards from an existing Trello board, allowing filtering and customization of fields for cards, attachments, and members |
| `get-boards-cards-by-id-board-by-filter` | `trello.getBoardsCardsByIdBoardByFilter()` | `--filter` `--idBoard` | 0 | Retrieves cards from a specified Trello board, filtered by 'all' (all cards), 'closed' (archived only), 'open' (non-archived), or 'visible' (cards on non-archived lists) |
| `get-boards-cards-by-id-board-by-id-card` | `trello.getBoardsCardsByIdBoardByIdCard()` | `--idBoard` `--idCard` | 16 | Retrieves details for a specific Trello card by its ID and its parent board's ID, with options to customize returned fields for the card and associated data like attachments, actions, members, and… |
| `get-boards-checklists-by-id-board` | `trello.getBoardsChecklistsByIdBoard()` | `--idBoard` | 6 | Retrieves checklists (primarily structure/metadata, not detailed item history) from a Trello board, with options to include associated card and check item details and to control which fields are… |
| `get-boards-custom-fields` | `trello.getBoardsCustomFields()` | `--id` | 0 | Retrieve custom field definitions for a board |
| `get-boards-deltas-by-id-board` | `trello.getBoardsDeltasByIdBoard()` | `--idBoard` `--ixLastUpdate` `--tags` | 0 | Retrieves recent changes (deltas) for a Trello board by its ID, allowing tracking of modifications since a specified update sequence number (`ixLastUpdate`) |
| `get-boards-labels-by-id-board` | `trello.getBoardsLabelsByIdBoard()` | `--idBoard` | 2 | Fetches labels for a specified Trello board, aiding in its organization or label management; this action does not detail per-card label usage |
| `get-boards-labels-by-id-board-by-id-label` | `trello.getBoardsLabelsByIdBoardByIdLabel()` | `--idBoard` `--idLabel` | 1 | Fetches specified fields for a specific label on a Trello board; this read-only action does not return information about which cards the label is attached to |
| `get-boards-lists-by-id-board` | `trello.getBoardsListsByIdBoard()` | `--idBoard` | 4 | Retrieves lists from a specified Trello board, with options to filter lists and include card details |
| `get-boards-lists-by-id-board-by-filter` ·deprecated | `trello.getBoardsListsByIdBoardByFilter()` | `--filter` `--idBoard` | 0 | Use TRELLO_BOARD_GET_LISTS_BY_ID_BOARD instead |
| `get-boards-members-by-id-board` | `trello.getBoardsMembersByIdBoard()` | `--idBoard` | 3 | Retrieves members of a Trello board, with options to filter the list and select specific member fields to return |
| `get-boards-members-cards-by-id-board-by-id-member` | `trello.getBoardsMembersCardsByIdBoardByIdMember()` | `--idBoard` `--idMember` | 13 | Retrieves cards for a member on a board, with options to customize returned fields and related data; member must have board access |
| `get-boards-members-invited-by-id-board` | `trello.getBoardsMembersInvitedByIdBoard()` | `--idBoard` | 1 | Retrieves a list of members invited to a specific Trello board who have not yet joined |
| `get-boards-members-invited-by-id-board-by-field` | `trello.getBoardsMembersInvitedByIdBoardByField()` | `--field` `--idBoard` | 0 | Retrieves a specific field (e.g., email, username) for members who have been invited to a Trello board but have not yet joined |
| `get-boards-memberships-by-id-board` | `trello.getBoardsMembershipsByIdBoard()` | `--idBoard` | 3 | Retrieves Trello board memberships (user roles and permissions) for auditing access or managing collaboration, returning only membership data and not other board content |
| `get-boards-memberships-by-id-board-by-id-membership` | `trello.getBoardsMembershipsByIdBoardByIdMembership()` | `--idBoard` `--idMembership` | 2 | Retrieves a specific membership on a Trello board by its ID, optionally including member details |
| `get-boards-my-prefs-by-id-board` | `trello.getBoardsMyPrefsByIdBoard()` | `--idBoard` | 0 | Retrieves the authenticated user's preferences for a specific Trello board |
| `get-boards-organization-by-id-board` | `trello.getBoardsOrganizationByIdBoard()` | `--idBoard` | 1 | Fetches information about the Trello Workspace (organization) to which a specific board belongs, returning details for the Workspace only, not the board itself or its content |
| `get-boards-organization-by-id-board-by-field` | `trello.getBoardsOrganizationByIdBoardByField()` | `--field` `--idBoard` | 0 | Retrieves a specific field from the organization associated with a Trello board, useful for obtaining targeted details without fetching the entire organization object |
| `get-boards-plugins-by-id-board` | `trello.getBoardsPluginsByIdBoard()` | `--id` | 1 | Retrieves Power-Ups (plugins) enabled on a Trello board |
| `get-cards-actions-by-id-card` | `trello.getCardsActionsByIdCard()` | `--idCard` | 14 | Retrieves the history of actions (e.g., comments, updates, moves) for a Trello card specified by `idCard`; the card must exist and very old actions might not be available |
| `get-cards-attachments-by-id-card` | `trello.getCardsAttachmentsByIdCard()` | `--idCard` | 2 | Retrieves attachments for a Trello card |
| `get-cards-attachments-by-id-card-by-id-attachment` | `trello.getCardsAttachmentsByIdCardByIdAttachment()` | `--idAttachment` `--idCard` | 1 | Retrieves a specific attachment from a Trello card by card ID and attachment ID |
| `get-cards-board-by-id-card` | `trello.getCardsBoardByIdCard()` | `--idCard` | 1 | Fetches detailed information about the Trello board to which a specific, existing, and accessible card belongs, using the card's ID or short link |
| `get-cards-board-by-id-card-by-field` | `trello.getCardsBoardByIdCardByField()` | `--field` `--idCard` | 0 | Retrieves a specific field from the board associated with a given Trello card |
| `get-cards-by-id-card` | `trello.getCardsByIdCard()` | `--idCard` | 23 | Retrieves a Trello card by its ID or shortlink, with options to include related data like actions, attachments, members, and checklists |
| `get-cards-by-id-card-by-field` | `trello.getCardsByIdCardByField()` | `--field` `--idCard` | 0 | Retrieves the value of a single, specified field from a Trello card |
| `get-cards-check-item` | `trello.getCardsCheckItem()` | `--id` `--idCheckItem` | 1 | Retrieve a specific checkItem on a card |
| `get-cards-check-item-states-by-id-card` | `trello.getCardsCheckItemStatesByIdCard()` | `--idCard` | 1 | Gets the completed checklist items on a Trello card |
| `get-cards-checklists-by-id-card` | `trello.getCardsChecklistsByIdCard()` | `--idCard` | 6 | Retrieves all checklists, including their check items, for a Trello card specified by its ID or shortlink, if the card exists and is accessible |
| `get-cards-custom-field-items-by-id-card` | `trello.getCardsCustomFieldItemsByIdCard()` | `--idCard` | 0 | Retrieve a card's customFieldItems array |
| `get-cards-list-by-id-card` | `trello.getCardsListByIdCard()` | `--idCard` | 1 | Gets the Trello list to which a specified card (which must exist) belongs |
| `get-cards-list-by-id-card-by-field` | `trello.getCardsListByIdCardByField()` | `--field` `--idCard` | 0 | Fetches a specific field from the Trello list that a given card belongs to |
| `get-cards-members-by-id-card` | `trello.getCardsMembersByIdCard()` | `--idCard` | 1 | Retrieves members of a Trello card, identified by its ID or shortLink, allowing customization of which member fields are returned |
| `get-cards-members-voted-by-id-card` | `trello.getCardsMembersVotedByIdCard()` | `--idCard` | 1 | Fetches members who voted on a Trello card; requires an existing card ID, the Voting Power-Up to be active on the board, and members to have voted; returns member details, not vote counts |
| `get-cards-plugin-data-by-id` | `trello.getCardsPluginDataById()` | `--id` | 0 | Retrieve any shared pluginData on a card |
| `get-cards-stickers-by-id-card` | `trello.getCardsStickersByIdCard()` | `--idCard` | 1 | Retrieves all visual stickers (used for categorization, emphasis, or decoration) from an existing and accessible Trello card; this read-only action does not affect other card elements |
| `get-cards-stickers-by-id-card-by-id-sticker` | `trello.getCardsStickersByIdCardByIdSticker()` | `--idCard` `--idSticker` | 1 | Call this action to retrieve detailed properties (like image, position, rotation) of a specific sticker on a Trello card |
| `get-check-item-by-id` | `trello.getCheckItemById()` | `--idCheckItem` `--idChecklist` | 1 | Retrieves a specific check item from a checklist using the checklist ID and check item ID |
| `get-checklists-board-by-id-checklist` | `trello.getChecklistsBoardByIdChecklist()` | `--idChecklist` | 1 | Retrieves the Trello board a specific checklist belongs to, using the checklist ID |
| `get-checklists-board-by-id-checklist-by-field` | `trello.getChecklistsBoardByIdChecklistByField()` | `--field` `--idChecklist` | 0 | Retrieves a specified `field` (e.g., 'name', 'desc') from the Trello board associated with the given `idChecklist` |
| `get-checklists-by-id-checklist` | `trello.getChecklistsByIdChecklist()` | `--idChecklist` | 5 | Fetches a Trello checklist by its `idChecklist`, requiring the ID to refer to an existing checklist, and allows specifying which details of the checklist, its cards, and check items are returned |
| `get-checklists-by-id-checklist-by-field` | `trello.getChecklistsByIdChecklistByField()` | `--field` `--idChecklist` | 0 | Retrieves a specific field's value from a Trello checklist by its ID and the field name, without loading the entire checklist object or its items |
| `get-checklists-cards-by-id-checklist` | `trello.getChecklistsCardsByIdChecklist()` | `--idChecklist` | 13 | Retrieves cards associated with a specific, valid Trello checklist ID, allowing for filtering and customization of card and related entity data fields |
| `get-checklists-check-items-by-id-checklist` | `trello.getChecklistsCheckItemsByIdChecklist()` | `--idChecklist` | 2 | Retrieves all check items from a Trello checklist |
| `get-labels-board-by-id-label` | `trello.getLabelsBoardByIdLabel()` | `--idLabel` | 1 | Retrieves the Trello board to which a given, valid Trello label ID (`idLabel`) belongs |
| `get-labels-board-by-id-label-by-field` | `trello.getLabelsBoardByIdLabelByField()` | `--field` `--idLabel` | 0 | Retrieves a specified `field` (e.g., 'name', 'url') from the Trello board associated with a given `idLabel` |
| `get-labels-by-id-label` | `trello.getLabelsByIdLabel()` | `--idLabel` | 1 | Retrieves detailed information for a specific Trello label by its ID, allowing selection of specific fields to return |
| `get-lists-actions-by-id-list` | `trello.getListsActionsByIdList()` | `--idList` | 14 | Retrieves actions (like card movements or comments, newest first) for a Trello list by its ID, to track history or create activity logs |
| `get-lists-board-by-id-list` ·common | `trello.getListsBoardByIdList()` | `--idList` | 1 | Retrieves the board to which a specific Trello list belongs |
| `get-lists-board-by-id-list-by-field` | `trello.getListsBoardByIdListByField()` | `--field` `--idList` | 0 | Retrieves a specific field (e.g., 'name', 'desc', 'url') from the Trello board associated with a given list ID |
| `get-lists-by-id-list` | `trello.getListsByIdList()` | `--idList` | 5 | Retrieves a Trello list by its unique ID, optionally including details for its cards and parent board |
| `get-lists-by-id-list-by-field` | `trello.getListsByIdListByField()` | `--field` `--idList` | 0 | Fetches the value of a single, specified field from a Trello list |
| `get-lists-cards-by-id-list` | `trello.getListsCardsByIdList()` | `--idList` | 13 | Fetches cards from a Trello list by its ID, with options to filter and customize the returned card data |
| `get-member-board-background` | `trello.getMemberBoardBackground()` | `--idBoardBackground` `--idMember` | 1 | Retrieves a specific custom board background for a Trello member by its ID |
| `get-member-custom-bg` | `trello.getMemberCustomBg()` | `--idBoardBackground` `--idMember` | 1 | Retrieves metadata (e.g., brightness, URLs, tiling status) for a specific custom board background of a Trello member, not the image file itself |
| `get-member-custom-emoji` | `trello.getMemberCustomEmoji()` | `--idCustomEmoji` `--idMember` | 1 | Retrieves a specific custom emoji by its ID for a Trello member, requiring that both the member and emoji exist and are associated |
| `get-member-invited-org` | `trello.getMemberInvitedOrg()` | `--field` `--idMember` | 0 | Get a specific field of an organization to which the member has a pending invitation; returns data only if such an invitation exists |
| `get-member-org-cards` | `trello.getMemberOrgCards()` | `--idMember` `--idOrg` | 13 | Fetches all cards assigned to a specific member of a given Trello organization |
| `get-members-actions-by-id-member` | `trello.getMembersActionsByIdMember()` | `--idMember` | 14 | Retrieves a list of actions for a specified Trello member, allowing filtering by type, date, models, and control over output format and fields |
| `get-members-board-backgrounds-by-id-member` | `trello.getMembersBoardBackgroundsByIdMember()` | `--idMember` | 1 | Fetches the board backgrounds for a specified Trello member |
| `get-members-board-stars-by-id-member` | `trello.getMembersBoardStarsByIdMember()` | `--idMember` | 0 | Fetches only the boards a specific Trello member has starred, identified by their ID or username |
| `get-members-board-stars-by-id-member-by-id-board-star` | `trello.getMembersBoardStarsByIdMemberByIdBoardStar()` | `--idBoardStar` `--idMember` | 0 | Retrieves detailed information about a specific board star (a Trello board marked as a favorite) for a given Trello member |
| `get-members-boards-by-id-member` | `trello.getMembersBoardsByIdMember()` | — | 13 | Retrieves board-level details (not lists/cards) for Trello boards associated with a member ID or username, allowing extensive customization of the returned data |
| `get-members-boards-by-id-member-by-filter` | `trello.getMembersBoardsByIdMemberByFilter()` | `--idMember` | 2 | Retrieves a list of boards for a specific Trello member, applying a filter such as 'open', 'starred', or 'all' |
| `get-members-boards-invited-by-id-member` | `trello.getMembersBoardsInvitedByIdMember()` | — | 2 | Retrieves Trello boards to which a specific member has been invited but has not yet joined |
| `get-members-boards-invited-by-id-member-by-field` | `trello.getMembersBoardsInvitedByIdMemberByField()` | `--field` `--idMember` | 0 | Retrieves a specific field from Trello boards to which a member has been invited but not yet joined; returns an empty result for no pending invitations |
| `get-members-by-id-member` ·common | `trello.getMembersByIdMember()` | `--idMember` | 52 | Fetches comprehensive information about a Trello member, specified by ID or username, including profile, activities, boards, cards, notifications, and organization affiliations, with customizable… |
| `get-members-by-id-member-by-field` | `trello.getMembersByIdMemberByField()` | `--field` `--idMember` | 0 | Efficiently retrieves a specific field (e.g., fullName, username, bio) of a Trello member using their ID or username, without fetching the entire member profile |
| `get-members-cards-by-id-member` | `trello.getMembersCardsByIdMember()` | `--idMember` | 13 | Retrieves cards for a Trello member, specified by ID or username, with options to filter cards and include related data like actions, attachments, and checklists |
| `get-members-custom-board-backgrounds-by-id-member` | `trello.getMembersCustomBoardBackgroundsByIdMember()` | `--idMember` | 1 | Retrieves custom board backgrounds for a Trello member, who must exist, using their ID or username |
| `get-members-custom-emoji-by-id-member` | `trello.getMembersCustomEmojiByIdMember()` | `--idMember` | 1 | Retrieves all custom (user-specific, non-standard) emojis that a specified Trello member has created or can access |
| `get-members-custom-stickers-by-id-member` | `trello.getMembersCustomStickersByIdMember()` | `--idMember` | 1 | Retrieves a member's custom stickers, which are unique personalized stickers created by them, distinct from standard Trello stickers |
| `get-members-custom-stickers-by-id-member-by-id-sticke` | `trello.getMembersCustomStickersByIdMemberByIdSticke()` | `--idCustomSticker` `--idMember` | 1 | Get member custom sticker |
| `get-members-deltas-by-id-member` | `trello.getMembersDeltasByIdMember()` | `--idMember` `--ixLastUpdate` `--tags` | 0 | Retrieves a chronological list of all changes (deltas) made by a specific Trello member, including modifications to boards, lists, and cards, to audit activity or sync data |
| `get-members-me` ·common | `trello.getMembersMe()` | — | 10 | Retrieve information about the currently authenticated Trello member |
| `get-members-me-boards` ·common ·deprecated | `trello.getMembersMeBoards()` | — | 2 | Use TRELLO_MEMBER_GET_BOARDS_BY_ID_MEMBER instead |
| `get-members-notifications-by-id-member` | `trello.getMembersNotificationsByIdMember()` | `--idMember` | 11 | Retrieves notifications for a Trello member, specified by their ID or username, with options for filtering and pagination |
| `get-members-organizations-by-id-member` | `trello.getMembersOrganizationsByIdMember()` | `--idMember` | 3 | Fetches organizations a specific Trello member belongs to; the `idMember` must be an ID or username of an existing Trello member |
| `get-members-organizations-invited-by-id-member` | `trello.getMembersOrganizationsInvitedByIdMember()` | `--idMember` | 1 | Retrieves organizations a Trello member has been invited to but has not yet accepted or declined |
| `get-members-saved-searches-by-id-member` | `trello.getMembersSavedSearchesByIdMember()` | `--idMember` | 0 | Retrieves all saved search queries for a Trello member; this action only retrieves saved searches and does not execute them |
| `get-members-saved-searches-by-id-member-by-id-saved-s` | `trello.getMembersSavedSearchesByIdMemberByIdSavedS()` | `--idMember` `--idSavedSearch` | 0 | Get Member Saved Search |
| `get-members-tokens-by-id-member` | `trello.getMembersTokensByIdMember()` | `--idMember` | 1 | Retrieves API token metadata for a Trello member |
| `get-notifications-board-by-id-notification` | `trello.getNotificationsBoardByIdNotification()` | `--idNotification` | 1 | Gets the Trello board associated with a given notification ID, returning only board data and allowing selection of specific board fields |
| `get-notifications-board-by-id-notification-by-field` | `trello.getNotificationsBoardByIdNotificationByField()` | `--field` `--idNotification` | 0 | Retrieves a specific field from the board associated with a Trello notification |
| `get-notifications-by-id-notification` | `trello.getNotificationsByIdNotification()` | `--idNotification` | 14 | Retrieves a specific Trello notification by its ID, optionally including related entities and specific fields for the notification and its related entities |
| `get-notifications-by-id-notification-by-field` | `trello.getNotificationsByIdNotificationByField()` | `--field` `--idNotification` | 0 | Retrieves a specific field from a Trello notification |
| `get-notifications-card-by-id-notification` | `trello.getNotificationsCardByIdNotification()` | `--idNotification` | 1 | Retrieves the card associated with a Trello notification |
| `get-notifications-card-by-id-notification-by-field` | `trello.getNotificationsCardByIdNotificationByField()` | `--field` `--idNotification` | 0 | Retrieves a specific field of a Trello card, using the ID of a notification that is directly associated with that card |
| `get-notifications-display-by-id-notification` | `trello.getNotificationsDisplayByIdNotification()` | `--idNotification` | 0 | Retrieves the information needed to display an existing Trello notification, identified by its ID, without altering the notification or fetching its complete metadata |
| `get-notifications-entities-by-id-notification` | `trello.getNotificationsEntitiesByIdNotification()` | `--idNotification` | 0 | Retrieves the entities (members, cards, boards, lists, etc.) associated with a specific Trello notification |
| `get-notifications-list-by-id-notification` | `trello.getNotificationsListByIdNotification()` | `--idNotification` | 1 | Retrieves the Trello list associated with a specific notification ID, for notifications linked to a list (e.g., card creation or movement notifications) |
| `get-notifications-list-by-id-notification-by-field` | `trello.getNotificationsListByIdNotificationByField()` | `--field` `--idNotification` | 0 | Efficiently retrieves a single specified field from a Trello list linked to a notification, avoiding fetching the entire list |
| `get-notifications-member-by-id-notification` | `trello.getNotificationsMemberByIdNotification()` | `--idNotification` | 1 | Fetches details of the member (not the notification content itself) associated with a specific Trello notification ID |
| `get-notifications-member-by-id-notification-by-field` | `trello.getNotificationsMemberByIdNotificationByField()` | `--field` `--idNotification` | 0 | Retrieves a specific field value of the Trello member associated with a notification |
| `get-notifications-member-creator-by-id-notification` | `trello.getNotificationsMemberCreatorByIdNotification()` | `--idNotification` | 1 | Fetches the creator (member) of a Trello notification, identified by `idNotification`, returning only creator details and respecting Trello privacy settings and user permissions |
| `get-notifications-member-creator-by-id-notification-b` | `trello.getNotificationsMemberCreatorByIdNotificationB()` | `--field` `--idNotification` | 0 | Get notification creator field |
| `get-notifications-organization-by-id-notification` | `trello.getNotificationsOrganizationByIdNotification()` | `--idNotification` | 1 | Retrieves the Trello organization linked to a specific notification ID; returns organization details only, not the notification itself |
| `get-notifications-organization-by-id-notification-by-` | `trello.getNotificationsOrganizationByIdNotificationBy()` | `--field` `--idNotification` | 0 | Get notification organization field |
| `get-org-membership` | `trello.getOrgMembership()` | `--idMembership` `--idOrg` | 2 | Retrieves a specific membership within a Trello organization, using their respective IDs, to ascertain the member's role, status, or permissions |
| `get-org-new-billable-guests-by-board` | `trello.getOrgNewBillableGuestsByBoard()` | `--id` `--idBoard` | 0 | Check for new billable guests on a board within an organization |
| `get-organizations-actions-by-id-org` | `trello.getOrganizationsActionsByIdOrg()` | `--idOrg` | 14 | Retrieves a log of actions (e.g., card creations, list movements, comments) for a specified Trello organization, filterable by type, date range, and models; `idOrg` must be a valid organization… |
| `get-organizations-boards-by-id-org` | `trello.getOrganizationsBoardsByIdOrg()` | `--idOrg` | 12 | Fetches boards for a Trello organization, specified by its ID or name, with options to filter and customize returned data |
| `get-organizations-by-id-org` | `trello.getOrganizationsByIdOrg()` | `--idOrg` | 25 | Retrieves detailed information about a specific Trello organization, including optional related resources like members, boards, and actions, using its ID or unique name |
| `get-organizations-by-id-org-by-field` | `trello.getOrganizationsByIdOrgByField()` | `--field` `--idOrg` | 0 | Retrieves the value of a single specified `field` for a Trello organization `idOrg`, ideal for efficiently fetching a specific piece of information without loading the full organization details |
| `get-organizations-deltas-by-id-org` | `trello.getOrganizationsDeltasByIdOrg()` | `--idOrg` `--ixLastUpdate` `--tags` | 0 | Retrieves a log of recent modifications (deltas) for a Trello organization, filterable by tags and supporting incremental fetching via an update index |
| `get-organizations-members-by-id-org` | `trello.getOrganizationsMembersByIdOrg()` | `--idOrg` | 3 | Retrieves members of a Trello organization (specified by ID or name), with an option to include member activity if the organization is Premium |
| `get-organizations-members-invited-by-id-org` | `trello.getOrganizationsMembersInvitedByIdOrg()` | `--idOrg` | 1 | Retrieves members invited to a Trello organization who have not yet accepted their invitation, returning only data for pending invitations (not active or former members) and cannot send or modify… |
| `get-organizations-members-invited-by-id-org-by-field` | `trello.getOrganizationsMembersInvitedByIdOrgByField()` | `--field` `--idOrg` | 0 | Retrieves a specific `field` (e.g., fullName, username, email, status) for members with pending invitations to the Trello organization specified by `idOrg` |
| `get-organizations-memberships-by-id-org` | `trello.getOrganizationsMembershipsByIdOrg()` | `--idOrg` | 3 | Fetches organization-level memberships for a Trello organization, with options to filter members and include their details; does not return board-specific memberships |
| `get-organizations-plugin-data` | `trello.getOrganizationsPluginData()` | `--id` | 0 | Get organization-scoped pluginData on a Trello Workspace |
| `get-organizations-tags-by-id` | `trello.getOrganizationsTagsById()` | `--id` | 0 | Lists all collections (tags) associated with a Trello organization |
| `get-search` | `trello.getSearch()` | `--query` | 19 | Searches Trello content (e.g., boards, cards, members) within specified organizations using a query and customizable result fields |
| `get-search-members` | `trello.getSearchMembers()` | `--query` | 4 | Searches Trello members by name, username, or email, optionally scoped to a board or organization |
| `get-sessions-socket` | `trello.getSessionsSocket()` | — | 0 | Retrieves WebSocket session connection information from Trello for real-time updates |
| `get-tokens-by-token` | `trello.getTokensByToken()` | `--token` | 2 | Retrieves information about a specific Trello API token, allowing selection of specific fields and inclusion of webhook details |
| `get-tokens-by-token-by-field` | `trello.getTokensByTokenByField()` | `--field` | 0 | Retrieves a specific field from a Trello token, provided the token is valid, has necessary permissions, and the field is a valid token field |
| `get-tokens-member-by-token` | `trello.getTokensMemberByToken()` | — | 1 | Retrieves information about the Trello member associated with the current API token, allowing customization of the returned fields |
| `get-tokens-member-by-token-by-field` | `trello.getTokensMemberByTokenByField()` | `--field` | 0 | Retrieves a specific field for the Trello member associated with the current API token |
| `get-tokens-webhooks-by-token` | `trello.getTokensWebhooksByToken()` | — | 0 | Retrieves all webhooks associated with a specific Trello API token |
| `get-tokens-webhooks-by-token-by-id-webhook` | `trello.getTokensWebhooksByTokenByIdWebhook()` | `--idWebhook` | 0 | Retrieves detailed information for a specific Trello webhook, identified by `idWebhook`, that is associated with the given `token` |
| `get-types-by-id` | `trello.getTypesById()` | `--id` | 0 | Identifies the type of a Trello resource (member or organization) given its ID |
| `get-webhooks-by-id-webhook` | `trello.getWebhooksByIdWebhook()` | `--idWebhook` | 0 | Retrieves the full configuration and status for a specific Trello webhook by its unique ID; this action does not return past notification history |
| `get-webhooks-by-id-webhook-by-field` | `trello.getWebhooksByIdWebhookByField()` | `--field` `--idWebhook` | 0 | Gets a specific field's value from a Trello webhook, avoiding retrieval of the full webhook object |
| `list-emoji` | `trello.listEmoji()` | — | 2 | List all available emoji in Trello |
| `mark-all-notifications-read` | `trello.markAllNotificationsRead()` | — | 0 | Marks all Trello notifications for the authenticated user as read across all boards; this action is permanent and cannot be undone |
| `mark-board-as-viewed` | `trello.markBoardAsViewed()` | `--idBoard` | 0 | Marks the Trello board specified by idBoard as viewed for the current user, exclusively updating its viewed status and potentially influencing its position in user-specific lists and notification… |
| `mark-card-notifications-read` | `trello.markCardNotificationsRead()` | `--idCard` | 0 | Marks all notifications associated with a specific Trello card as read; this is irreversible and only affects read status, not deleting or modifying notifications |
| `move-all-list-cards` | `trello.moveAllListCards()` | `--idBoard` `--idList` `--idListDestination` | 0 | Moves all cards from a source Trello list to a destination list on a specified board |
| `remove-board-member` | `trello.removeBoardMember()` | `--idBoard` `--idMember` | 0 | Permanently removes a current member from a Trello board, revoking their access; this action is irreversible |
| `remove-board-star` | `trello.removeBoardStar()` | `--idBoardStar` `--idMember` | 0 | Removes a specific starred board (identified by `idBoardStar`) from a Trello member's (identified by `idMember`) list of favorites; `idBoardStar` must be an existing star for that member |
| `remove-card-label-by-color` | `trello.removeCardLabelByColor()` | `--color` `--idCard` | 0 | Permanently removes a specific `color` label from an existing Trello card identified by `idCard`, if the card has that label; this only disassociates the label from the card, not deleting the label… |
| `remove-label-from-card` | `trello.removeLabelFromCard()` | `--idCard` `--idLabel` | 0 | Removes a specific label from a Trello card; the label itself is not deleted from the board, only its association with the card |
| `remove-member-from-card` | `trello.removeMemberFromCard()` | `--idCard` `--idMember` | 0 | Removes a currently assigned member from a Trello card, affecting only the card's member list and not the member's board membership or overall permissions |
| `remove-member-from-org` | `trello.removeMemberFromOrg()` | `--idMember` `--idOrg` | 0 | Removes a member entirely from a specific Trello organization, including from all its boards and cards; this action is permanent and does not delete the member's Trello account |
| `update-actions-by-id-action` | `trello.updateActionsByIdAction()` | `--idAction` | 1 | Updates the `text` field of a specific Trello comment action, identified by `idAction` |
| `update-actions-text-by-id-action` | `trello.updateActionsTextByIdAction()` | `--idAction` | 1 | Updates the text of an existing Trello action (e.g., a comment or card update) identified by `idAction`; this change only affects the action's text content |
| `update-board-membership` | `trello.updateBoardMembership()` | `--idBoard` `--idMembership` | 2 | Updates a user's role (e.g., admin, normal, observer) on a specific Trello board or retrieves updated member details, requiring existing board and membership IDs |
| `update-board-sidebar-actions-prefs` | `trello.updateBoardSidebarActionsPrefs()` | `--idBoard` | 1 | Updates the current user's preference for the visibility of sidebar board actions on a specific Trello board |
| `update-board-sidebar-activity-prefs` | `trello.updateBoardSidebarActivityPrefs()` | `--idBoard` | 1 | Sets the current user's preference for displaying or concealing the sidebar activity feed on an accessible Trello board; this change only affects the requesting user |
| `update-board-sidebar-members-pref` | `trello.updateBoardSidebarMembersPref()` | `--idBoard` | 1 | Updates the authenticated user's preference for showing or hiding members in a specific Trello board's sidebar, affecting only the current user's view |
| `update-board-stars-position-by-id-member-by-id-board-` | `trello.updateBoardStarsPositionByIdMemberByIdBoard()` | `--idBoardStar` `--idMember` | 1 | Update board star position |
| `update-boards-by-id-board` | `trello.updateBoardsByIdBoard()` | `--idBoard` | 31 | Updates attributes (e.g., name, description, status, preferences) of an existing Trello board identified by `idBoard` |
| `update-boards-closed-by-id-board` | `trello.updateBoardsClosedByIdBoard()` | `--idBoard` | 1 | Archives (closes) an active Trello board or reopens a previously archived board |
| `update-boards-desc-by-id-board` | `trello.updateBoardsDescByIdBoard()` | `--idBoard` | 1 | Updates the description of a specified Trello board; the update is immediate and does not affect other board elements like lists, cards, or membership |
| `update-boards-id-organization-by-id-board` | `trello.updateBoardsIdOrganizationByIdBoard()` | `--idBoard` | 1 | Moves an existing Trello board to a specified, existing Trello organization, which can affect the board's visibility and member access |
| `update-boards-label-names-blue-by-id-board` | `trello.updateBoardsLabelNamesBlueByIdBoard()` | `--idBoard` | 1 | Sets the name of the blue label for a Trello board |
| `update-boards-label-names-green-by-id-board` | `trello.updateBoardsLabelNamesGreenByIdBoard()` | `--idBoard` | 1 | Updates the name of the green label for a specified Trello board; this change is board-wide, affects all cards using this label, and does not change the label's color |
| `update-boards-label-names-orange-by-id-board` | `trello.updateBoardsLabelNamesOrangeByIdBoard()` | `--idBoard` | 1 | Updates the name of the orange label for a specified Trello board |
| `update-boards-label-names-purple-by-id-board` | `trello.updateBoardsLabelNamesPurpleByIdBoard()` | `--idBoard` | 1 | Updates the name of the purple label on a Trello board |
| `update-boards-label-names-red-by-id-board` | `trello.updateBoardsLabelNamesRedByIdBoard()` | `--idBoard` | 1 | Updates the name of the red label on a Trello board |
| `update-boards-label-names-yellow-by-id-board` | `trello.updateBoardsLabelNamesYellowByIdBoard()` | `--idBoard` | 1 | Updates the name of a board's yellow label; other colored labels are unaffected |
| `update-boards-members-by-id-board` | `trello.updateBoardsMembersByIdBoard()` | `--idBoard` | 3 | Adds or updates a member's role on a specific Trello board, typically requiring the member's `email` and a membership `type` |
| `update-boards-members-by-id-board-by-id-member` | `trello.updateBoardsMembersByIdBoardByIdMember()` | `--idBoard` `--idMember` | 3 | Updates a current member's email, full name, or role (admin, normal, or observer) on a specific Trello board; email and full name changes are board-specific and do not affect the member's global… |
| `update-boards-my-prefs-email-position-by-id-board` | `trello.updateBoardsMyPrefsEmailPositionByIdBoard()` | `--idBoard` | 1 | Updates a Trello board's email position preference for new cards; this preference only affects new cards (not existing ones) and the board must exist |
| `update-boards-my-prefs-id-email-list-by-id-board` | `trello.updateBoardsMyPrefsIdEmailListByIdBoard()` | `--idBoard` `--value` | 0 | Sets the default Trello list where cards created via email will be added for a specific board |
| `update-boards-my-prefs-show-list-guide-by-id-board` ·deprecated | `trello.updateBoardsMyPrefsShowListGuideByIdBoard()` | `--idBoard` | 1 | Updates the 'Show List Guide' preference for a specified Trello board |
| `update-boards-my-prefs-show-sidebar-by-id-board` | `trello.updateBoardsMyPrefsShowSidebarByIdBoard()` | `--idBoard` `--value` | 0 | Updates the authenticated user's personal preference for showing or hiding the sidebar on a specific Trello board |
| `update-boards-name-by-id-board` | `trello.updateBoardsNameByIdBoard()` | `--idBoard` | 1 | Updates the name of an existing Trello board, identified by `idBoard`; this change only affects the board's name, not its other attributes |
| `update-boards-prefs-background-by-id-board` | `trello.updateBoardsPrefsBackgroundByIdBoard()` | `--idBoard` | 1 | Updates the cosmetic background preference for a specific Trello board; this change does not affect board functionality or content |
| `update-boards-prefs-calendar-feed-enabled-by-id-board` | `trello.updateBoardsPrefsCalendarFeedEnabledByIdBoard()` | `--idBoard` | 1 | Updates the 'calendarFeedEnabled' preference for a Trello board, which, when enabled, makes board cards with due dates accessible via an iCalendar feed for external calendar integration |
| `update-boards-prefs-card-aging-by-id-board` | `trello.updateBoardsPrefsCardAgingByIdBoard()` | `--idBoard` | 1 | Updates the card aging visual preference to 'pirate' or 'regular' mode for a specified Trello board |
| `update-boards-prefs-card-covers-by-id-board` | `trello.updateBoardsPrefsCardCoversByIdBoard()` | `--idBoard` `--value` | 0 | Updates the preference on a specific Trello board for whether existing card covers are displayed; this controls visibility only and does not add or remove the actual covers from cards |
| `update-boards-prefs-comments-by-id-board` | `trello.updateBoardsPrefsCommentsByIdBoard()` | `--idBoard` `--value` | 0 | Changes the permission settings for who can add comments to cards on a specific Trello board, without affecting other board settings |
| `update-boards-prefs-invitations-by-id-board` | `trello.updateBoardsPrefsInvitationsByIdBoard()` | `--idBoard` | 1 | Updates who can invite new members ('admins' or 'members') to a specific Trello board |
| `update-boards-prefs-permission-level-by-id-board` | `trello.updateBoardsPrefsPermissionLevelByIdBoard()` | `--idBoard` | 1 | Updates the permission level preference (e.g., 'private' or 'public') for a Trello board, identified by `idBoard`, if the board exists and the authenticated user possesses administrative permissions… |
| `update-boards-prefs-self-join-by-id-board` | `trello.updateBoardsPrefsSelfJoinByIdBoard()` | `--idBoard` `--value` | 0 | Updates a board's 'selfJoin' preference, determining if members can join freely or must be invited |
| `update-boards-prefs-voting-by-id-board` | `trello.updateBoardsPrefsVotingByIdBoard()` | `--idBoard` | 1 | Sets who can vote on cards for an existing Trello board, changing only the voting preferences for all cards on the board |
| `update-boards-subscribed-by-id-board` | `trello.updateBoardsSubscribedByIdBoard()` | `--idBoard` `--value` | 0 | Updates the authenticated user's subscription status (subscribe/unsubscribe for notifications) for a specified Trello board, to which the user must have access |
| `update-cards-actions-comments-by-id-card-by-id-action` | `trello.updateCardsActionsCommentsByIdCardByIdAction()` | `--idAction` `--idCard` | 1 | Updates the text for a given comment action (`idAction`) on a specified card (`idCard`), affecting only the text content |
| `update-cards-by-id-card` | `trello.updateCardsByIdCard()` | `--idCard` | 16 | Updates an existing Trello card's attributes like name, description, due date, members, labels, position, or archives/unarchives it, attaches files, or changes its cover |
| `update-cards-checklist-items-by-id-card-by-id-checkli` | `trello.updateCardsChecklistItemsByIdCardByIdCheckli()` | `--id` `--idCheckItem` | 7 | Update check item on card |
| `update-cards-checklist-items-position-by-id-card-by-i` | `trello.updateCardsChecklistItemsPositionByIdCardByI()` | `--idCard` `--idCheckItem` `--idChecklist` `--value` | 0 | Update checklist item position |
| `update-cards-checklist-items-state-by-id-card-by-id-c` | `trello.updateCardsChecklistItemsStateByIdCardByIdC()` | `--idCard` `--idCheckItem` `--idChecklist` | 1 | Update card checklist item state |
| `update-cards-checklists-check-items-name-by-id-card-b` | `trello.updateCardsChecklistsCheckItemsNameByIdCardB()` | `--idCard` `--idCheckItem` `--idChecklist` | 1 | Update checklist item name in card |
| `update-cards-closed-by-id-card` | `trello.updateCardsClosedByIdCard()` | `--idCard` `--value` | 0 | Updates the 'closed' status of an existing Trello card |
| `update-cards-desc-by-id-card` | `trello.updateCardsDescByIdCard()` | `--idCard` | 1 | Updates or clears the entire description of an existing Trello card; use an empty string for `value` to clear |
| `update-cards-due-by-id-card` | `trello.updateCardsDueByIdCard()` | `--idCard` | 1 | Updates the due date of a specific Trello card; the card identified by `idCard` must exist |
| `update-cards-id-attachment-cover-by-id-card` | `trello.updateCardsIdAttachmentCoverByIdCard()` | `--idCard` | 1 | Sets or removes the attachment cover for a Trello card |
| `update-cards-id-board-by-id-card` | `trello.updateCardsIdBoardByIdCard()` | `--idCard` | 2 | Moves a Trello card to a different board and, optionally, to a specific list on that new board, useful for reorganizing across projects or workflows |
| `update-cards-id-list-by-id-card` | `trello.updateCardsIdListByIdCard()` | `--idCard` `--value` | 0 | Moves a Trello card to a different list on the same Trello board; this operation is idempotent and only updates the card's list ID |
| `update-cards-id-members-by-id-card` | `trello.updateCardsIdMembersByIdCard()` | `--idCard` | 1 | Updates (sets/replaces) the list of members assigned to a Trello card |
| `update-cards-labels-by-id-card` | `trello.updateCardsLabelsByIdCard()` | `--idCard` `--value` | 0 | Replaces all labels on a Trello card with labels matching the specified colors |
| `update-cards-name-by-id-card` | `trello.updateCardsNameByIdCard()` | `--idCard` `--value` | 0 | Updates the name of an existing Trello card, identified by its ID or shortLink; other card properties remain unchanged |
| `update-cards-pos-by-id-card` | `trello.updateCardsPosByIdCard()` | `--idCard` | 1 | Updates a Trello card's position within its list to 'top', 'bottom', or a specified 1-indexed positive integer |
| `update-cards-stickers-by-id-card-by-id-sticker` | `trello.updateCardsStickersByIdCardByIdSticker()` | `--idCard` `--idSticker` | 5 | Updates an existing sticker's image, position (top, left coordinates), or stacking order (zIndex) on a specific Trello card; the `rotate` parameter may not be supported by Trello |
| `update-cards-subscribed-by-id-card` | `trello.updateCardsSubscribedByIdCard()` | `--idCard` `--value` | 0 | Updates the user's subscription status for a Trello card, if the card exists and is accessible |
| `update-checklist-item-by-ids` | `trello.updateChecklistItemByIds()` | `--idCard` `--idCheckItem` `--idChecklistCurrent` | 4 | Updates a check item's attributes (name, position, state) or moves it to a different checklist on the same card, requiring the card ID, current checklist ID, and check item ID |
| `update-checklists-by-id-checklist` | `trello.updateChecklistsByIdChecklist()` | `--idChecklist` | 5 | Updates an existing Trello checklist, allowing modification of its name, position, associated card/board, or copying items from a source checklist |
| `update-checklists-by-id-checklist-by-field` | `trello.updateChecklistsByIdChecklistByField()` | `--field` `--id` `--value` | 0 | Update a specific field on a Trello checklist |
| `update-checklists-id-card-by-id-checklist` | `trello.updateChecklistsIdCardByIdChecklist()` | `--idChecklist` | 1 | Moves a Trello checklist to a new parent card; the checklist and the destination card must exist |
| `update-checklists-name-by-id-checklist` | `trello.updateChecklistsNameByIdChecklist()` | `--idChecklist` | 1 | Updates the name of an existing Trello checklist |
| `update-checklists-pos-by-id-checklist` | `trello.updateChecklistsPosByIdChecklist()` | `--idChecklist` | 1 | Updates the position of an existing checklist on a Trello card |
| `update-labels-by-id-label` | `trello.updateLabelsByIdLabel()` | `--idLabel` | 3 | Updates an existing Trello label's attributes (color, name, or associated board) by its ID; the label must exist |
| `update-labels-by-id-label-by-field` | `trello.updateLabelsByIdLabelByField()` | `--field` `--id` `--value` | 0 | Updates a specific field (color or name) on a Trello label by its ID |
| `update-labels-color-by-id-label` | `trello.updateLabelsColorByIdLabel()` | `--idLabel` | 1 | Updates the color of an existing Trello label, or removes its color if 'null' is specified for the value |
| `update-labels-name-by-id-label` | `trello.updateLabelsNameByIdLabel()` | `--idLabel` | 1 | Updates the name of an existing Trello label, identified by `idLabel`; an empty string for `value` clears the label's name but does not delete the label |
| `update-lists-by-id-list` | `trello.updateListsByIdList()` | `--idList` | 6 | Updates attributes of an existing Trello list, such as name, position, archive status, board, or copies cards from another list, provided the list `idList` exists |
| `update-lists-closed-by-id-list` | `trello.updateListsClosedByIdList()` | `--idList` | 1 | Updates whether an existing Trello list is closed (archived); a closed list is hidden from the board view but not deleted and can be re-opened |
| `update-lists-id-board-by-id-list` | `trello.updateListsIdBoardByIdList()` | `--idList` `--value` | 1 | Moves an existing Trello list (identified by `idList`) to an existing destination board (board ID in `value`), optionally setting its new position (`pos`) |
| `update-lists-name-by-id-list` | `trello.updateListsNameByIdList()` | `--idList` `--value` | 0 | Updates the name of an existing Trello list, identified by its ID; this only changes the list's name, not its cards or position |
| `update-lists-pos-by-id-list` | `trello.updateListsPosByIdList()` | `--idList` | 1 | Changes a Trello list's order on a board to 'top', 'bottom', or a specified numeric position, affecting only its position |
| `update-lists-subscribed-by-id-list` | `trello.updateListsSubscribedByIdList()` | `--idList` `--value` | 0 | Updates the subscription status for a Trello list, allowing the user to subscribe or unsubscribe to control notifications |
| `update-member-avatar` | `trello.updateMemberAvatar()` | `--idMember` | 1 | Updates a Trello member's avatar using a base64-encoded image; the `file` field, though schema-optional, requires valid image data for a successful update |
| `update-members-avatar-source-by-id-member` | `trello.updateMembersAvatarSourceByIdMember()` | `--idMember` `--value` | 0 | Updates the avatar source for a specified Trello member |
| `update-members-bio-by-id-member` | `trello.updateMembersBioByIdMember()` | `--idMember` | 1 | Updates the bio/description of a specified Trello member |
| `update-members-board-backgrounds-by-id-member-by-id-b` | `trello.updateMembersBoardBackgroundsByIdMemberByIdB()` | `--idBoardBackground` `--idMember` | 3 | Update Member Board Background |
| `update-members-board-stars-by-id-member-by-id-board-s` | `trello.updateMembersBoardStarsByIdMemberByIdBoardS()` | `--idBoardStar` `--idMember` | 2 | Update Member Board Star |
| `update-members-by-id-member` | `trello.updateMembersByIdMember()` | `--idMember` | 8 | Updates an existing Trello member's profile information, preferences, or username |
| `update-members-custom-board-backgrounds-by-id-member-` | `trello.updateMembersCustomBoardBackgroundsByIdMember()` | `--idBoardBackground` `--idMember` | 3 | Update member's custom board background |
| `update-members-full-name-by-id-member` | `trello.updateMembersFullNameByIdMember()` | `--idMember` | 1 | Updates the full name for a Trello member, identified by their valid ID or username; this operation only affects the full name, leaving other profile information unchanged |
| `update-members-initials-by-id-member` | `trello.updateMembersInitialsByIdMember()` | `--idMember` | 1 | Updates the initials for a specified Trello member, identified by their ID or username |
| `update-members-prefs-color-blind-by-id-member` | `trello.updateMembersPrefsColorBlindByIdMember()` | `--value` | 1 | Updates a Trello member's color blind friendly mode preference |
| `update-members-prefs-locale-by-id-member` | `trello.updateMembersPrefsLocaleByIdMember()` | `--idMember` | 1 | Updates a Trello member's locale preference to change how dates, times, and numbers are displayed in the Trello UI |
| `update-members-prefs-summary-interval-by-id-member` | `trello.updateMembersPrefsSummaryIntervalByIdMember()` | `--value` | 1 | Updates a Trello member's preference for the frequency of email summary notifications; this setting affects only summary notifications |
| `update-members-saved-searches-by-id-member-by-id-save` | `trello.updateMembersSavedSearchesByIdMemberByIdSave()` | `--idMember` `--idSavedSearch` | 3 | Update member saved search |
| `update-members-saved-searches-name-by-id-member-by-id` | `trello.updateMembersSavedSearchesNameByIdMemberById()` | `--idMember` `--idSavedSearch` `--value` | 0 | Update member saved search name |
| `update-members-saved-searches-pos-by-id-member-by-id-` | `trello.updateMembersSavedSearchesPosByIdMemberById()` | `--idMember` `--idSavedSearch` `--value` | 0 | Update member saved search position |
| `update-members-saved-searches-query-by-id-member-by-i` | `trello.updateMembersSavedSearchesQueryByIdMemberByI()` | `--idMember` `--idSavedSearch` `--value` | 0 | Update member saved search query |
| `update-members-username-by-id-member` | `trello.updateMembersUsernameByIdMember()` | `--idMember` `--value` | 0 | Updates the username for an existing Trello member, identified by their ID or current username |
| `update-notifications-by-id-notification` | `trello.updateNotificationsByIdNotification()` | `--idNotification` | 1 | Updates only the 'unread' status of a specific Trello notification |
| `update-notifications-unread-by-id-notification` | `trello.updateNotificationsUnreadByIdNotification()` | `--idNotification` | 1 | Updates the unread status of a specific Trello notification |
| `update-org-google-apps-version` | `trello.updateOrgGoogleAppsVersion()` | `--idOrg` | 1 | Updates the Google Apps integration version preference for a specified Trello organization, to manage compatibility or features related to Google Workspace services |
| `update-org-invite-restrictions` | `trello.updateOrgInviteRestrictions()` | `--idOrg` `--value` | 0 | Adds an email domain restriction to a Trello organization's invitation policy |
| `update-organization-logo` | `trello.updateOrganizationLogo()` | `--file` `--idOrg` | 0 | Sets or updates the logo for a Trello organization; the provided image file must adhere to Trello's format and size restrictions |
| `update-organizations-by-id-org` | `trello.updateOrganizationsByIdOrg()` | `--idOrg` | 12 | Updates various attributes of an existing Trello organization, identified by `idOrg` |
| `update-organizations-desc-by-id-org` | `trello.updateOrganizationsDescByIdOrg()` | `--idOrg` | 1 | Updates or clears the description for an existing Trello organization, identified by its ID or name, to a new string up to 16384 characters |
| `update-organizations-display-name-by-id-org` | `trello.updateOrganizationsDisplayNameByIdOrg()` | `--idOrg` `--value` | 0 | Updates the display name of a Trello organization, identifiable by its current ID or name (`idOrg`), to the new `value`; other attributes remain unaffected |
| `update-organizations-members-by-id-org` | `trello.updateOrganizationsMembersByIdOrg()` | `--idOrg` | 3 | Adds/updates a member in a specified Trello organization (`idOrg`); `email` and `type` are API-required, `fullName` is needed if `email` is new to Trello |
| `update-organizations-members-by-id-org-by-id-member` | `trello.updateOrganizationsMembersByIdOrgByIdMember()` | `--idMember` `--idOrg` `--type` | 0 | Updates a member's role/type (admin, normal, or observer) in a Trello organization |
| `update-organizations-members-deactivation-by-id-org-b` | `trello.updateOrganizationsMembersDeactivationByIdOrgB()` | `--idMember` `--idOrg` `--value` | 0 | Update org member deactivation status |
| `update-organizations-memberships-by-id-org-by-id-memb` | `trello.updateOrganizationsMembershipsByIdOrgByIdMemb()` | `--idMembership` `--idOrg` | 2 | Update org membership |
| `update-organizations-name-by-id-org` | `trello.updateOrganizationsNameByIdOrg()` | `--idOrg` `--value` | 0 | Updates the unique programmatic identifier (used in URLs and API interactions) for an existing Trello organization; this is an irreversible operation, effective immediately, and only affects this… |
| `update-organizations-prefs-associated-domain-by-id-or` | `trello.updateOrganizationsPrefsAssociatedDomainByIdOr()` | `--idOrg` | 1 | Update an organization's associated domain preferences |
| `update-organizations-prefs-board-visibility-by-id-org` | `trello.updateOrganizationsPrefsBoardVisibilityByIdOrg()` | `--idOrg` | 1 | Updates the preference controlling who can set board visibility to 'organization-visible' within an existing Trello organization |
| `update-organizations-prefs-external-members-access-by` | `trello.updateOrganizationsPrefsExternalMembersAccessBy()` | `--idOrg` | 1 | Update an organization's external members access |
| `update-organizations-prefs-permission-level-by-id-org` | `trello.updateOrganizationsPrefsPermissionLevelByIdOrg()` | `--idOrg` | 1 | Updates a Trello organization's `permissionLevel` preference, determining if it's members-only or link-accessible, and affecting new board default visibility |
| `update-organizations-prefs-private-board-visibility-b` | `trello.updateOrganizationsPrefsPrivateBoardVisibilityB()` | `--idOrg` `--value` | 0 | Update organization private board visibility restriction |
| `update-organizations-prefs-public-board-visibility-by` | `trello.updateOrganizationsPrefsPublicBoardVisibilityBy()` | `--idOrg` | 1 | Update organization public board visibility |
| `update-organizations-website-by-id-org` | `trello.updateOrganizationsWebsiteByIdOrg()` | `--idOrg` | 1 | Updates the website URL for a specified Trello organization |
| `update-sessions-by-id-session` | `trello.updateSessionsByIdSession()` | `--idSession` | 2 | Updates a Trello user session's viewed board ID or status; call when user activity or board focus changes |
| `update-sessions-status-by-id-session` | `trello.updateSessionsStatusByIdSession()` | `--idSession` | 1 | Updates the status of an existing Trello session |
| `update-webhooks-active-by-id-webhook` | `trello.updateWebhooksActiveByIdWebhook()` | `--idWebhook` `--value` | 0 | Updates the active status of an existing Trello webhook |
| `update-webhooks-by-id-webhook` | `trello.updateWebhooksByIdWebhook()` | `--idWebhook` | 4 | Updates an existing Trello webhook's description, active status, callback URL, or monitored model ID; requires the webhook ID (not in request body) to be specified, typically via URL path |
| `update-webhooks-callback-url-by-id-webhook` | `trello.updateWebhooksCallbackUrlByIdWebhook()` | `--idWebhook` `--value` | 0 | Updates the callback URL for a specific Trello webhook; other webhook attributes remain unchanged |
| `update-webhooks-description-by-id-webhook` | `trello.updateWebhooksDescriptionByIdWebhook()` | `--idWebhook` | 1 | Updates the description of an existing Trello webhook; an empty string for the new description removes the current one |
| `update-webhooks-id-model-by-id-webhook` | `trello.updateWebhooksIdModelByIdWebhook()` | `--idWebhook` `--value` | 0 | Updates the `idModel` (the monitored Trello entity like a board, list, or card) for an active webhook `idWebhook` to the new model ID `value`; other webhook properties are unaffected |

## Triggers

`trello.on("<event>", handler)` in a script; required config goes before the handler as an object.

| Event | Name | Required config | Description |
|---|---|---|---|
| `"archived-card"` | Card Archived Trigger | `board_id` | Triggered when a card is archived in the specified board |
| `"new-activity"` | New Activity Trigger | — | Triggered when there is activity in Trello |
| `"new-board"` | New Board Trigger | `workspace_id` | Triggered when a board is created in the specified workspace |
| `"new-card"` | New Card Trigger | `board_id` | Triggered when a card is created in the specified board |
| `"updated-card"` | Card Updated Trigger | `card_id` | Triggered when a specific card is updated |

## Docs

- [run CLI](https://docs.boxd.sh/cli/run): Call connected integrations from the shell, connect new ones, and run automations.
- [Quickstart](https://docs.boxd.sh/guides/integrations/quickstart): Connect an integration, call it from the shell, and turn a script into an automation.
- [Connections](https://docs.boxd.sh/guides/integrations/connections): Connect an account once, for yourself or for your whole organization.
- [Scripts](https://docs.boxd.sh/guides/automations/scripts): Typed integrations, triggers, schedules and state in a .run.ts file.
- [Jobs](https://docs.boxd.sh/guides/automations/jobs): How a script becomes a background job: states, retries, sleep and wake.
- [Beyond the catalog](https://docs.boxd.sh/guides/automations/beyond-the-catalog): Reach your own APIs, databases and cloud accounts from a script.