# Trello A web-based, kanban-style, list-making application. - **Category:** project management - **Auth:** OAUTH1 - **Composio Managed App Available?** Yes - **Tools:** 329 - **Triggers:** 5 - **Slug:** `TRELLO` - **Version:** 20260316_00 ## Tools ### Add board **Slug:** `TRELLO_ADD_BOARDS` Creates a new Trello board; the 'name' parameter is required for creation, and various preferences can be customized or cloned from a source board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `desc` | string | No | Description for the Trello board (0-16384 characters). | | `name` | string | No | Name for the new Trello board (1-16384 characters). This field is required for board creation. | | `closed` | string | No | Whether the board should be immediately archived (closed). | | `powerUps` | string | No | Power-Ups to enable (e.g., 'calendar,voting', 'all'; valid: 'calendar', 'cardAging', 'recap', 'voting'). | | `subscribed` | string | No | Whether the creator is automatically subscribed to the board. | | `prefs_voting` | string | No | Who can vote on cards ('disabled', 'members', 'observers', 'org', 'public'); corresponds to API parameter 'prefs_voting'. | | `idBoardSource` | string | No | ID of an existing Trello board to use as a template. | | `prefs__voting` | string | No | Who can vote on cards ('disabled', 'members', 'observers', 'org', 'public'); corresponds to API parameter 'prefs/voting'. | | `idOrganization` | string | No | ID or name of the Trello Workspace (formerly Organization) for this board. | | `keepFromSource` | string | No | Components to copy if 'idBoardSource' is used (e.g., 'cards,labels', 'all'; valid: 'cards', 'lists', 'checklists', 'stickers', 'members', 'customFields', 'prefs', 'labels'). | | `prefs_comments` | string | No | Who can comment on cards ('disabled', 'members', 'observers', 'org', 'public'); corresponds to API parameter 'prefs_comments'. | | `prefs_selfJoin` | string | No | Whether Workspace members can join the board themselves; corresponds to API parameter 'prefs_selfJoin'. | | `labelNames__red` | string | No | Name for the red label (0-16384 characters); corresponds to API parameter 'labelNames/red'. | | `prefs__comments` | string | No | Who can comment on cards ('disabled', 'members', 'observers', 'org', 'public'); corresponds to API parameter 'prefs/comments'. | | `prefs__selfJoin` | string | No | Whether Workspace members can join the board themselves; corresponds to API parameter 'prefs/selfJoin'. | | `prefs_cardAging` | string | No | Card aging style ('pirate' or 'regular'); corresponds to API parameter 'prefs_cardAging'. | | `labelNames__blue` | string | No | Name for the blue label (0-16384 characters); corresponds to API parameter 'labelNames/blue'. | | `prefs__cardAging` | string | No | Card aging style ('pirate' or 'regular'); corresponds to API parameter 'prefs/cardAging'. | | `prefs_background` | string | No | Board background (standard name, custom ID, or hex code; 0-16384 characters); corresponds to API parameter 'prefs_background'. | | `prefs_cardCovers` | string | No | Whether card covers are shown; corresponds to API parameter 'prefs_cardCovers'. | | `labelNames__green` | string | No | Name for the green label (0-16384 characters); corresponds to API parameter 'labelNames/green'. | | `prefs__background` | string | No | Board background (standard name like 'blue', 'pink', or custom ID); corresponds to API parameter 'prefs/background'. | | `prefs__cardCovers` | string | No | Whether card covers are shown; corresponds to API parameter 'prefs/cardCovers'. | | `prefs_invitations` | string | No | Who can invite to the board ('admins' or 'members'); corresponds to API parameter 'prefs_invitations'. | | `labelNames__orange` | string | No | Name for the orange label (0-16384 characters); corresponds to API parameter 'labelNames/orange'. | | `labelNames__purple` | string | No | Name for the purple label (0-16384 characters); corresponds to API parameter 'labelNames/purple'. | | `labelNames__yellow` | string | No | Name for the yellow label (0-16384 characters); corresponds to API parameter 'labelNames/yellow'. | | `prefs__invitations` | string | No | Who can invite to the board ('admins' or 'members'); corresponds to API parameter 'prefs/invitations'. | | `prefs_permissionLevel` | string | No | Board visibility and permission level ('org', 'private', 'public'); corresponds to API parameter 'prefs_permissionLevel'. | | `prefs__permissionLevel` | string | No | Board visibility and permission level ('org', 'private', 'public'); corresponds to API parameter 'prefs/permissionLevel'. | | `prefs__calendarFeedEnabled` | string | No | Whether the calendar feed is enabled; corresponds to API parameter 'prefs/calendarFeedEnabled'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add new list to board (Deprecated) **Slug:** `TRELLO_ADD_BOARDS_LISTS_BY_ID_BOARD` DEPRECATED: Use TRELLO_LIST_CREATE_LIST instead. Creates a new, empty list on a specified, existing Trello board, typically used as a column or category for organizing cards. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pos` | string | No | The position of the new list on the board. Valid values are 'top', 'bottom', or a positive number (e.g., 1, 2.5, 3). If not provided, the list is added to the bottom. | | `name` | string | Yes | The name for the new list. Must be a string with a length from 1 to 16384 characters. | | `idBoard` | string | Yes | The ID of the board to which the new list will be added. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add card **Slug:** `TRELLO_ADD_CARDS` Creates a new card in a Trello list. Only `idList` is required; `idBoard` is optional as the API determines the board from the list. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `due` | string | No | Due date for the card (date string or 'null' to remove). | | `pos` | string | No | Position in list: 'top', 'bottom', or a positive float. | | `desc` | string | No | Card description (0-16384 characters). | | `name` | string | No | Name/title for the card. Highly recommended for new cards. If omitted, a blank title is created. When using 'idCardSource' to copy a card, the name is copied from the source unless overridden here. | | `closed` | string | No | Archive (close) the card. Valid values: 'true', 'false'. | | `idList` | string | Yes | ID of the list to add the card to. Must be a 24-character hexadecimal string. | | `idBoard` | string | No | ID of the board for the card. Must be a 24-character hexadecimal string. Optional - the API automatically determines the board from idList. | | `idLabels` | string | No | Comma-separated list of label IDs to add. Each ID must be a 24-character hexadecimal string. | | `idMembers` | string | No | Comma-separated list of member IDs to assign. Each ID must be a 24-character hexadecimal string. | | `urlSource` | string | No | URL to attach to the card. If a Trello card URL is provided, the card is copied from that source. Use 'null' or omit if not needed. | | `fileSource` | string | No | Binary data of a file to attach. | | `subscribed` | string | No | Subscribe user to the card. Valid values: 'true', 'false'. | | `idCardSource` | string | No | ID of an existing card to copy. Must be a 24-character hexadecimal string. When provided, the new card inherits name and other properties from the source card. | | `keepFromSource` | string | No | If using `idCardSource`, properties to copy: 'all' or comma-separated (e.g., 'attachments', 'checklists', 'due'). | | `idAttachmentCover` | string | No | ID of an image attachment on this card for its cover, or 'null' for no cover. Must be a 24-character hexadecimal string or 'null'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add comment to card **Slug:** `TRELLO_ADD_CARDS_ACTIONS_COMMENTS_BY_ID_CARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `text` | string | Yes | Comment text, between 1 and 16384 characters. Supports @mentions to notify Trello users. | | `idCard` | string | Yes | ID or shortLink of the Trello card to add the comment to. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add attachment to card **Slug:** `TRELLO_ADD_CARDS_ATTACHMENTS_BY_ID_CARD` Adds an attachment to a Trello card by `idCard`; specify either a `file` to upload or a `url` to link, but not both. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `url` | string | No | URL of an external resource to attach if not uploading a `file`. Must start with 'http://' or 'https://'. | | `file` | string | No | Path to the local file to attach if not linking a `url`. | | `name` | string | No | Desired name for the attachment. If omitted, Trello uses the original filename or a URL-derived default. Max length 256. | | `idCard` | string | Yes | ID or shortLink of the Trello card. | | `mimeType` | string | No | MIME type of the attachment, aiding Trello in file handling. Max length 256. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add checklist to card via id **Slug:** `TRELLO_ADD_CARDS_CHECKLISTS_BY_ID_CARD` 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 checklist's name), or `name` to create a new empty checklist from scratch. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | The name for the new checklist. Used when creating a new checklist from scratch or when copying from `idChecklistSource`. If `value` specifies an existing checklist ID to add, this `name` is ignored. String with a length from 0 to 16384 characters. | | `value` | string | No | The ID of a pre-existing checklist to add directly to the card. If an ID is provided here, that specific checklist is added. If `null` or omitted, a new checklist will be created on the card (either empty using `name`, or by copying from `idChecklistSource`). | | `idCard` | string | Yes | The ID or shortLink of the card to which the checklist will be added. | | `idChecklistSource` | string | No | The ID of an existing checklist to copy. If provided (and `value` is not an ID of an existing checklist to add), a new checklist is created on the card by duplicating this source checklist. The `name` parameter can be used to specify a name for the newly created checklist. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add label to card **Slug:** `TRELLO_ADD_CARDS_ID_LABELS_BY_ID_CARD` Adds an existing label to a Trello card; `idCard` identifies the card and `value` is the ID of the label to add. Both card and label must already exist. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The ID of the label to add. Label IDs are typically 24-character hexadecimal strings. | | `idCard` | string | Yes | The ID or shortLink of the Trello card. Card IDs are typically 24-character hexadecimal strings. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add member vote to card **Slug:** `TRELLO_ADD_CARD_VOTE` Casts a 'yes' vote for a specified member on a Trello card; a member can only vote once per card. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The ID of the member to cast a 'yes' vote on the card. Must be a valid 24-character member ID. Note: Voting must be enabled on the board for this action to succeed. | | `idCard` | string | Yes | The ID of the card to add the vote to. Must be the full 24-character card ID, not a short link. For example, `571d07b591c8b68aeb4f6acc`. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add check item to checklist (Deprecated) **Slug:** `TRELLO_ADD_CHECKLIST_ITEM` DEPRECATED: Use TRELLO_ADD_CHECKLISTS_CHECK_ITEMS_BY_ID_CHECKLIST instead. Adds a new check item to an existing checklist on a specific Trello card. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pos` | string | Yes | The position of the new check item within the checklist. Valid values are 'top', 'bottom', or a positive number (e.g., '1', '2.5'). | | `name` | string | Yes | The name of the check item to be created. Must be a string with a length between 1 and 16384 characters. | | `idCard` | string | Yes | The ID or short link of the card where the checklist resides. | | `idChecklist` | string | Yes | The ID of the checklist to which the new check item will be added. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add checklist to card **Slug:** `TRELLO_ADD_CHECKLISTS` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pos` | string | No | The position of the new checklist on its card. Accepted values are 'top', 'bottom', or a positive number (integer or float). | | `name` | string | No | The name for the new checklist. Required if `idChecklistSource` is not provided. Must be a string with length between 0 and 16384 characters. | | `idCard` | string | No | The ID of the Trello card to which the checklist will be added. If provided, the checklist is added to this specific card. One of `idBoard` or `idCard` is required. | | `idBoard` | string | No | The ID of the Trello board. If `idCard` is not specified, this board will be targeted, potentially for creating a new card to host the checklist. One of `idBoard` or `idCard` is required. | | `idChecklistSource` | string | No | The ID of an existing checklist to be copied. If provided, the `name` parameter is ignored, and the new checklist will be a duplicate of this source. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add check item to checklist **Slug:** `TRELLO_ADD_CHECKLISTS_CHECK_ITEMS_BY_ID_CHECKLIST` Adds a new check item to a specified Trello checklist; this action does not update existing check items. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pos` | string | No | Position for the new check item: 'top', 'bottom', or a positive number. Defaults to bottom. | | `name` | string | No | Name/title for the new check item (1-16384 characters). Required by the Trello API for successful creation. | | `checked` | string | No | Initial completion status: 'true' or 'false'. Defaults to unchecked. | | `idChecklist` | string | Yes | ID of the checklist to add the new check item to. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create label on board **Slug:** `TRELLO_ADD_LABELS` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | Name for the new label (0-16384 characters). **Required by the Trello API.** An empty string creates a color-only visual label. | | `color` | string | No | Color for the new label. Valid values: green, yellow, orange, red, purple, blue, sky, lime, pink, black (and their _dark/_light variants). If not specified, the label will have no color (color=null). | | `idBoard` | string | No | ID of the board for the new label. Must be a 24-character hexadecimal TrelloID (e.g., '60d5f2d97f5f8c008d3e9d6b'). Note: The 8-character shortLink from board URLs is NOT accepted by this endpoint. Required by the Trello API. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add new list to board **Slug:** `TRELLO_ADD_LISTS` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pos` | string | No | The position of the new list on the board. Valid values are `top`, `bottom`, or a positive number (e.g., '1', '2.5'). | | `name` | string | No | The name for the new list. Must be a string with a length from 1 to 16384 characters. This is a required parameter. | | `closed` | string | No | Indicates whether the list should be created as closed (archived). Set to `true` for closed, or `false` for open. | | `idBoard` | string | No | The ID of the board to which the new list should be added. This is a required parameter. | | `subscribed` | string | No | Indicates whether the user creating the list should be automatically subscribed to it. Set to `true` to subscribe, or `false` otherwise. | | `idListSource` | string | No | The ID of an existing list to copy when creating the new list. If provided, the new list will be a copy of this source list. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add card to list (Deprecated) **Slug:** `TRELLO_ADD_LISTS_CARDS_BY_ID_LIST` DEPRECATED: Use TRELLO_CARD_CREATE_AND_UPDATE instead. Creates a new card in a Trello list, which must be specified by an existing and accessible `idList`. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `due` | string | No | The due date for the new card, in ISO 8601 format (e.g., 'YYYY-MM-DDTHH:MM:SS.SSSZ') or null if no due date is set. | | `desc` | string | No | The description for the new card. A string with a length from 0 to 16384 characters. | | `name` | string | Yes | The name/title for the new card. Required. A non-empty string with a length from 1 to 16384 characters. | | `idList` | string | Yes | The ID of the Trello list where the new card will be created. | | `labels` | string | No | A comma-separated list of label colors to apply to the card. Valid colors: blue, green, orange, purple, red, yellow. Alternatively, 'all' can be used to apply all available label colors on the board. | | `idMembers` | string | No | A comma-separated list of member IDs (24-character hex strings) to assign to the new card. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add card member by id **Slug:** `TRELLO_ADD_MEMBER_TO_CARD` Assigns a Trello member to a specific Trello card by card ID (or short link) and member ID. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The ID of the Trello member to be added to the card. | | `idCard` | string | Yes | The ID or short link of the Trello card to which the member will be added. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Archive all cards in list **Slug:** `TRELLO_ARCHIVE_ALL_LIST_CARDS` Archives all cards in a Trello list; while cards can be restored via the Trello interface, this action does not provide an unarchive function. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idList` | string | Yes | The unique identifier of the Trello list from which all cards will be archived. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Convert checklist item to card **Slug:** `TRELLO_CONVERT_CHECKLIST_ITEM_TO_CARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idCard` | string | Yes | The ID or short link of the card containing the checklist and the item to be converted. | | `idCheckItem` | string | Yes | The ID of the checklist item that will be converted into a new card. | | `idChecklist` | string | Yes | The ID of the checklist that contains the specific item to be converted to a card. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add reaction to action **Slug:** `TRELLO_CREATE_ACTION_REACTION` Tool to add a new emoji reaction to a Trello action. Use when acknowledging comments or actions with reactions. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `native` | string | No | The emoji to add as a native unicode emoji. | | `unified` | string | No | The unified value of the emoji to add. | | `idAction` | string | Yes | The ID of the action to add a reaction to. | | `shortName` | string | No | The primary shortName of the emoji to add (e.g., '+1', 'heart', 'thumbsup'). See Trello emoji documentation for available emojis. | | `skinVariation` | string | No | The skin variation of the emoji to add. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add a label to a board **Slug:** `TRELLO_CREATE_BOARD_LABEL` Creates a new label on an existing Trello board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | The name for the new label. Must be a string with a length from 0 to 16384 characters. An empty string is allowed. | | `color` | string | No | The color for the new label. Provide a valid Trello label color name or null for no color. If not provided, Trello may assign a default color or no color. | | `idBoard` | string | Yes | The ID of the board to which the new label will be added. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add labels to card **Slug:** `TRELLO_CREATE_CARD_LABEL` 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 the board if a matching one (by name/color combination) doesn't already exist. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | Name for the label (0-16384 chars). If a label with this name exists on the board, it will be reused; otherwise, a new label with this name and specified color is created and added to the card. | | `color` | string | No | Label color name. Valid colors: green, yellow, orange, red, purple, blue, sky, lime, pink, black, or null for no color. Used if 'value' is not provided. | | `value` | string | No | Alternative way to specify label color by name. When using 'all', adds all default board labels to the card. Overrides 'color' parameter if both are provided. | | `idCard` | string | Yes | ID or shortlink of the card. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add sticker to card **Slug:** `TRELLO_CREATE_CARD_STICKER` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `top` | string | No | Vertical offset from card's top edge (pixels). Uses default position if omitted. | | `left` | string | No | Horizontal offset from card's left edge (pixels). Uses default position if omitted. | | `image` | string | No | Name of a default Trello sticker (e.g., 'taco-cool'), ID of a previously uploaded custom sticker. Length: 0-16384 chars. Uses default if omitted. | | `idCard` | string | Yes | ID or short link of the card. | | `rotate` | string | No | Rotation angle in degrees; positive rotates clockwise. Defaults to 0 if omitted. | | `zIndex` | string | No | Stacking order (z-index); higher values are on top. Must be an integer. Trello assigns a default layer if omitted. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add member board background **Slug:** `TRELLO_CREATE_MEMBER_BOARD_BACKGROUND` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `file` | string | No | The image file to be uploaded for the board background. This is typically a file path or a URL accessible by the system performing the upload. | | `tile` | string | No | Determines whether the background image should be tiled. Set to 'true' to tile the image or 'false' to display it as a single image. | | `idMember` | string | Yes | The ID or username of the Trello member. | | `brightness` | string | No | Specifies the brightness of the background. Valid values are 'dark', 'light', or 'unknown'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add board star to member **Slug:** `TRELLO_CREATE_MEMBER_BOARD_STAR` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pos` | string | Yes | The desired position for the new board star in the member's list of starred boards. Valid values are 'top', 'bottom', or a positive integer. | | `idBoard` | string | Yes | The ID of the Trello board to be starred. The board must exist and be accessible to the specified member. | | `idMember` | string | Yes | The ID or username of the Trello member for whom the board star will be added. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add custom board background for a member **Slug:** `TRELLO_CREATE_MEMBER_CUSTOM_BOARD_BACKGROUND` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `url` | string | No | URL of an external image to use as the custom board background. Must start with 'http://' or 'https://'. Either 'file' or 'url' must be provided. | | `file` | object | No | The image file to upload as the custom board background. Supported formats: PNG, JPEG, GIF. Either 'file' or 'url' must be provided. | | `tile` | string | No | Indicates whether the custom board background image should be tiled. Set to 'true' to enable tiling, or 'false' to disable it. | | `idMember` | string | Yes | The ID or username of the Trello member for whom the custom board background will be added. | | `brightness` | string | No | Specifies the brightness setting for the custom board background. Accepted values are 'dark', 'light', or 'unknown'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add custom emoji for a member **Slug:** `TRELLO_CREATE_MEMBER_CUSTOM_EMOJI` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `file` | string | No | Emoji image file to upload. Must adhere to Trello's image format and size guidelines. Sent as multipart/form-data. | | `name` | string | No | Unique name for the custom emoji (2-64 characters). | | `idMember` | string | Yes | ID or username of the member. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add custom sticker for member **Slug:** `TRELLO_CREATE_MEMBER_CUSTOM_STICKER` Uploads a custom sticker to a Trello member's collection, if the member's plan allows custom stickers and respects associated limits. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `file` | object | Yes | The sticker image file to upload. Trello recommends images to be 128x128 pixels for optimal display. Supported formats: PNG, JPG, GIF. | | `idMember` | string | Yes | The ID or username of the Trello member to whom the custom sticker will be added. Use 'me' for the authenticated member. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add saved search for member **Slug:** `TRELLO_CREATE_MEMBER_SAVED_SEARCH` Creates a new saved search with a specified name, position, and query for a Trello member. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pos` | string | Yes | The position of the saved search in the member's list of saved searches. Can be 'top', 'bottom', or a positive numerical value. | | `name` | string | Yes | The name for the saved search. Must be a non-empty string with at least one non-space character. | | `query` | string | Yes | The search query string to be saved. The string must have a length between 1 and 16384 characters. | | `idMember` | string | Yes | The ID or username of the Trello member for whom the saved search will be created. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create organization **Slug:** `TRELLO_CREATE_ORGANIZATION` 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). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `desc` | string | No | The description for the organization. Max length: 16384 characters. | | `name` | string | No | The unique, URL-friendly programmatic name for the organization. Must be lowercase, start with a letter, and contain only lowercase letters, numbers, and underscores. Max length: 16384 characters. If not provided, Trello will generate one based on the displayName. | | `website` | string | No | The URL of the organization's website. Must start with 'http://' or 'https://'. Can be null or an empty string if no website. | | `displayName` | string | No | The human-readable name for the organization. Min length: 1 character. Cannot begin or end with a space. This field is required. | | `prefs__permissionLevel` | string | No | The default permission level for new boards created within the organization. Allowed values: 'private' or 'public'. | | `prefs__associatedDomain` | string | No | The Google Workspace (formerly G Suite) domain to associate with the organization. This enables features like restricting membership to users from this domain. | | `prefs__googleAppsVersion` | string | No | The version of Google Workspace integration. Allowed values: '1' or '2'. | | `prefs__orgInviteRestrict` | string | No | Specifies restrictions on who can be invited to the organization, e.g., a comma-separated list of email domains ('@example.com,@mycompany.com') or specific email addresses. If not set, any Trello user can be invited. | | `prefs__externalMembersDisabled` | string | No | Determines if external members (guests) are disabled for the organization. Set to 'true' to disable, 'false' to enable. | | `prefs__boardVisibilityRestrict__org` | string | No | Controls creation of organization-visible boards. Allowed values: 'admin' (only admins can create), 'none' (cannot be created), 'org' (any member can create). | | `prefs__boardVisibilityRestrict__public` | string | No | Controls creation of public boards. Allowed values: 'admin' (only admins can create), 'none' (cannot be created), 'org' (any member can create). | | `prefs__boardVisibilityRestrict__private` | string | No | Controls creation of private boards. Allowed values: 'admin' (only admins can create), 'none' (cannot be created), 'org' (any member can create). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create new session **Slug:** `TRELLO_CREATE_SESSION` Creates or updates a Trello user session, optionally linking it to a specific board for status updates and setting the user's activity status. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `status` | string | No | Sets the user's current activity status for the session. | | `idBoard` | string | No | The ID of the Trello board to associate with this session for status updates. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create webhook **Slug:** `TRELLO_CREATE_WEBHOOK` Tool to create a new Trello webhook for monitoring changes to a board, card, list, or member. Use when you need to set up real-time notifications for model changes. The callback URL must be publicly accessible and respond to HEAD requests for validation. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `active` | boolean | No | Determines whether the webhook is active and sending POST requests. Defaults to true if not specified. | | `idModel` | string | Yes | ID of the model (board, card, list, or member) to be monitored by the webhook. | | `callbackURL` | string | Yes | A valid URL that is reachable with a HEAD and POST request. This is where Trello will send webhook notifications. | | `description` | string | No | A description for the webhook (0-16384 characters). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete action by id **Slug:** `TRELLO_DELETE_ACTION` 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 cannot be deleted. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idAction` | string | Yes | The ID of the Trello action to be deleted (typically a 24-character hexadecimal string). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete action reaction **Slug:** `TRELLO_DELETE_ACTION_REACTION` Permanently deletes a specified reaction from a Trello action. Use when you need to remove a reaction that was previously added to an action. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID of the reaction to delete. This is a unique identifier for the reaction. | | `idAction` | string | Yes | The ID of the Action from which to delete the reaction. This is a unique identifier for the action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete board by id **Slug:** `TRELLO_DELETE_BOARD` Permanently deletes a Trello board by its ID. This is an irreversible action that removes the board and all its contents. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The unique identifier of the board to delete. Must be a valid Trello board ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete card attachment **Slug:** `TRELLO_DELETE_CARD_ATTACHMENT` Permanently removes a specified attachment from a Trello card; this action is irreversible and requires that both the card and the attachment exist. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idCard` | string | Yes | The ID or short link of the card from which the attachment will be deleted. Card IDs can be short (e.g., 'FY2OWrnc') or long (e.g., '571d07b591c8b68aeb4f6acc'). | | `idAttachment` | string | Yes | The ID of the attachment to be deleted from the card. This is a unique identifier for the attachment. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete card checklist **Slug:** `TRELLO_DELETE_CARD_CHECKLIST` Permanently deletes a specific checklist from a Trello card. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idCard` | string | Yes | The ID or shortLink of the card from which the checklist will be deleted. The card must exist. | | `idChecklist` | string | Yes | The ID of the checklist to delete. The checklist must exist on the specified card. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete card action comment **Slug:** `TRELLO_DELETE_CARD_COMMENT` Deletes a specific comment action (identified by `idAction`) from a Trello card (identified by `idCard`); this operation is irreversible and only affects comments. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idCard` | string | Yes | The ID or shortLink of the Trello card from which the comment will be deleted. | | `idAction` | string | Yes | The ID of the comment action to be deleted. This identifies the specific comment within the card's activity. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete card by ID **Slug:** `TRELLO_DELETE_CARDS_BY_ID_CARD` Permanently deletes an archived Trello card specified by its `idCard`. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idCard` | string | Yes | The ID or shortLink of the card to be deleted. The card ID is a long alphanumeric string, while the shortLink is a shorter, unique identifier used in card URLs. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete member vote from card **Slug:** `TRELLO_DELETE_CARDS_MEMBERS_VOTED_BY_ID_CARD_BY_ID_MEMBER` Removes a member's vote from a Trello card. The operation requires the member to have already voted on the card; attempting to delete a non-existent vote returns a 400 error. Voting must be enabled on the board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idCard` | string | Yes | The ID or shortLink of the Trello card from which the member's vote will be removed. | | `idMember` | string | Yes | The unique ID of the Trello member whose vote will be removed from the card. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete card sticker **Slug:** `TRELLO_DELETE_CARDS_STICKERS_BY_ID_CARD_BY_ID_STICKER` Permanently removes a specific sticker (identified by `idSticker`) from a Trello card (identified by `idCard`). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idCard` | string | Yes | ID or short link of the card. | | `idSticker` | string | Yes | ID of the sticker to remove. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete checklist item **Slug:** `TRELLO_DELETE_CHECKLIST_ITEM` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idCheckItem` | string | Yes | The ID of the check item to be deleted. | | `idChecklist` | string | Yes | The ID of the checklist that contains the check item to be deleted. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete checklist by id **Slug:** `TRELLO_DELETE_CHECKLISTS_BY_ID_CHECKLIST` Permanently and irreversibly deletes a Trello checklist and all its items using the `idChecklist`. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idChecklist` | string | Yes | The ID of the checklist to be deleted. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete label by id **Slug:** `TRELLO_DELETE_LABELS_BY_ID_LABEL` Permanently deletes an existing label from a Trello board by its ID; this operation is irreversible via the API. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idLabel` | string | Yes | The unique identifier of the label to be deleted. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete member board background **Slug:** `TRELLO_DELETE_MEMBER_BOARD_BACKGROUND` Permanently deletes a specific custom board background belonging to the specified Trello member; this operation cannot be undone. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idMember` | string | Yes | ID or username of the Trello member; 'me' refers to the authenticated user. | | `idBoardBackground` | string | Yes | ID of the custom board background to delete. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete member custom sticker **Slug:** `TRELLO_DELETE_MEMBER_CUSTOM_STICKER` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idMember` | string | Yes | The ID or username of the Trello member. | | `idCustomSticker` | string | Yes | The ID of the custom sticker to be deleted from the member's collection. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete member saved search **Slug:** `TRELLO_DELETE_MEMBER_SAVED_SEARCH` Permanently deletes a specific saved search for a Trello member, used when the search is outdated or no longer needed. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idMember` | string | Yes | The ID or username of the Trello member whose saved search is to be deleted. | | `idSavedSearch` | string | Yes | The ID of the specific saved search to be deleted. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete organization by id **Slug:** `TRELLO_DELETE_ORGANIZATIONS_BY_ID_ORG` Permanently deletes a Trello organization and all its associated data; this action is irreversible and requires caution. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or unique name of the Trello organization. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete organization logo by id **Slug:** `TRELLO_DELETE_ORGANIZATIONS_LOGO_BY_ID_ORG` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or custom URL name of the Trello organization whose logo is to be deleted. This can be the organization's short ID or its registered name. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete organization member by IDs **Slug:** `TRELLO_DELETE_ORGANIZATIONS_MEMBERS_BY_ID_ORG_BY_ID_MEMBER` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or name of the Trello organization from which the member will be removed. | | `idMember` | string | Yes | The ID of the member to be removed from the organization. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete org associated domain **Slug:** `TRELLO_DELETE_ORG_ASSOCIATED_DOMAIN` 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 removal. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or unique name of the Trello organization. If using the name, provide the short, URL-friendly version (e.g., 'trelloorg' for an organization accessible at trello.com/trelloorg). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete org invite restriction **Slug:** `TRELLO_DELETE_ORG_INVITE_RESTRICT` Removes a previously set email address invitation restriction from a Trello organization. This is an Enterprise-only feature that requires admin privileges on the organization. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The unique identifier (ID) or name of the Trello organization. Note: This endpoint requires Trello Enterprise access with admin privileges. | | `value` | string | Yes | The email address to remove from the organization's invitation restrictions. Must be a valid email address that was previously added as an invite restriction. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete token **Slug:** `TRELLO_DELETE_TOKENS_BY_TOKEN` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `token_to_delete` | string | No | Optional: The specific token to delete. If not provided, the current authenticated token will be deleted. WARNING: Deleting the current authenticated token will revoke your API access. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete token webhook by id **Slug:** `TRELLO_DELETE_TOKENS_WEBHOOKS_BY_TOKEN_BY_ID_WEBHOOK` Deletes an existing webhook, specified by its `idWebhook`, thereby stopping its notifications. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idWebhook` | string | Yes | The unique identifier of the existing webhook to be deleted. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete webhook by id **Slug:** `TRELLO_DELETE_WEBHOOKS_BY_ID_WEBHOOK` Permanently deletes an existing Trello webhook by its `idWebhook`, an irreversible action that stops future notifications. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idWebhook` | string | Yes | The unique identifier of the webhook to be deleted. This ID is obtained when the webhook is created. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Power-Up from board **Slug:** `TRELLO_DISABLE_BOARD_POWER_UP` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idBoard` | string | Yes | The unique identifier of the Trello board from which the Power-Up will be removed. This is typically a 24-character hexadecimal string. | | `powerUp` | string | Yes | The plugin ID of the Power-Up to be removed from the board. Each Power-Up has a unique plugin ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Dismiss member message **Slug:** `TRELLO_DISMISS_MEMBER_MESSAGE` Dismisses a one-time message for a Trello member, adding it to their dismissed messages list. This endpoint marks a specific one-time message (notification, banner, or prompt) as dismissed for the specified member. Once dismissed, the message will not be shown to the user again. Common use cases include dismissing onboarding messages, feature announcements, or team-specific prompts. Requires write access to the member's account. Use 'me' as idMember for the authenticated user. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The message identifier to dismiss. This is a string key representing the one-time message, notification, or banner that should be marked as dismissed for the member. | | `idMember` | string | Yes | The ID or username of the Trello member. Use 'me' for the authenticated user. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add board power-up **Slug:** `TRELLO_ENABLE_BOARD_POWER_UP` Enables the Power-Up specified by the 'value' parameter on the board; processes one Power-Up enablement per call. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | Identifier for the built-in Trello Power-Up to enable (e.g., 'calendar', 'cardAging', 'recap', 'voting'). Only Trello's built-in Power-Ups are supported. | | `idBoard` | string | Yes | The ID of the Trello board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Generate board calendar key **Slug:** `TRELLO_GENERATE_BOARD_CALENDAR_KEY` Generates a new calendar key for the Trello board specified by `idBoard`, invalidating any previous key for that board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idBoard` | string | Yes | The unique identifier of the Trello board for which to generate a calendar key. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Generate email key for board **Slug:** `TRELLO_GENERATE_BOARD_EMAIL_KEY` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idBoard` | string | Yes | The unique identifier of the Trello board for which a new email key will be generated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board by action id **Slug:** `TRELLO_GET_ACTIONS_BOARD_BY_ID_ACTION` Retrieves details for the Trello board associated with a specific action ID, returning board information only. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Board fields to return: 'all', or a comma-separated list of field names. Allowed values: closed, dateLastActivity, dateLastView, desc, descData, idOrganization, invitations, invited, labelNames, memberships, name, pinned, powerUps, prefs, shortLink, shortUrl, starred, subscribed, url. | | `idAction` | string | Yes | ID of the Trello action to retrieve its associated board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get action's board field **Slug:** `TRELLO_GET_ACTIONS_BOARD_BY_ID_ACTION_BY_FIELD` Retrieves a specified `field` from the Trello board associated with the provided Trello `idAction`. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific board field to retrieve. All board fields are valid options. | | `idAction` | string | Yes | The ID of the Trello action. This action is used to identify the board from which a specific field will be retrieved. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get action by ID **Slug:** `TRELLO_GET_ACTIONS_BY_ID_ACTION` Retrieves detailed information about a specific Trello action by its ID. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies which fields to include in the response. Use 'all' or a comma-separated list of: 'data', 'date', 'idMemberCreator', or 'type'. | | `member` | string | No | Determines whether to include member details. | | `display` | string | No | Determines whether to include display-related information. | | `entities` | string | No | Determines whether to include related entities in the response. | | `idAction` | string | Yes | The ID of the action to retrieve. | | `memberCreator` | string | No | Determines whether to include details of the member who created the action. | | `member_fields` | string | No | Specifies which member fields to include. Use 'all' or a comma-separated list of: 'avatarHash', 'bio', 'bioData', 'confirmed', 'fullName', 'idPremOrgsAdmin', 'initials', 'memberType', 'products', 'status', 'url', or 'username'. | | `memberCreator_fields` | string | No | Specifies which fields of the member creator to include. Use 'all' or a comma-separated list of: 'avatarHash', 'bio', 'bioData', 'confirmed', 'fullName', 'idPremOrgsAdmin', 'initials', 'memberType', 'products', 'status', 'url', or 'username'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get action field by id **Slug:** `TRELLO_GET_ACTIONS_BY_ID_ACTION_BY_FIELD` Retrieves the value of a specific field (e.g., 'data', 'date', 'type') from a Trello action using its unique ID. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field of the action to retrieve (e.g., 'data', 'date', 'type'). Only one field can be retrieved per request. Consult Trello API documentation for valid action field names. | | `idAction` | string | Yes | The unique identifier of the Trello action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card by action ID **Slug:** `TRELLO_GET_ACTIONS_CARD_BY_ID_ACTION` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Comma-separated list of card fields to return, or 'all' for all fields. Common fields: name, desc, due, idBoard, idList, shortUrl, url. Other allowed values: badges, checkItemStates, closed, dateLastActivity, descData, email, idAttachmentCover, idChecklists, idLabels, idMembers, idMembersVoted, idShort, labels, manualCoverAttachment, pos, shortLink, subscribed. | | `idAction` | string | Yes | The ID of a Trello action that is associated with a card (e.g., createCard, commentCard, updateCard actions). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get action's card field **Slug:** `TRELLO_GET_ACTIONS_CARD_BY_ID_ACTION_BY_FIELD` Retrieves a specific field from the Trello card associated with the given action ID. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field of the card (e.g., `name`, `desc`, `idList`) to retrieve for the card associated with the specified action. | | `idAction` | string | Yes | ID of the Trello action whose associated card's field is to be retrieved. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get action display by ID **Slug:** `TRELLO_GET_ACTIONS_DISPLAY_BY_ID_ACTION` 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 the action. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idAction` | string | Yes | The unique identifier of the Trello action for which display information is to be retrieved. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get action entities by id **Slug:** `TRELLO_GET_ACTIONS_ENTITIES_BY_ID_ACTION` Retrieves all entities (e.g., boards, lists, cards, members) associated with a specific, existing Trello action ID. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idAction` | string | Yes | The ID of the Trello action to retrieve entities for, e.g., '592f11060f95a3d3d46a987a'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get an action's list **Slug:** `TRELLO_GET_ACTIONS_LIST_BY_ID_ACTION` Retrieves the Trello list associated with a specific Trello action ID, for actions linked to a list. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Determines which fields to include in the response. Specify 'all' or a comma-separated list of valid field names. Valid fields are: 'closed', 'idBoard', 'name', 'pos', or 'subscribed'. | | `idAction` | string | Yes | The ID of the Trello action for which to retrieve the associated list. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get field of action's list **Slug:** `TRELLO_GET_ACTIONS_LIST_BY_ID_ACTION_BY_FIELD` Retrieves a specific field of the list associated with a Trello action, returning only that single field's value. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field of the list to retrieve. Valid fields are: 'closed' (boolean indicating if list is archived), 'idBoard' (ID of the board containing the list), 'name' (name of the list), 'pos' (position of the list), 'subscribed' (whether the user is subscribed to the list). | | `idAction` | string | Yes | The ID of the Trello action for which to retrieve the associated list's field. This must be an action that is associated with a list (e.g., createCard, commentCard, updateList, moveCardToBoard). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get action's member by id **Slug:** `TRELLO_GET_ACTIONS_MEMBER_BY_ID_ACTION` Retrieves the Trello member who was the subject of an action (not the creator). This endpoint returns information about the member who was acted upon in actions like: - addMemberToCard: Returns the member who was added to a card - removeMemberFromCard: Returns the member who was removed from a card - addMemberToBoard: Returns the member who was added to a board Note: For actions that don't involve a member as a subject (e.g., createCard, createBoard), this endpoint returns 404. Use /actions/{idAction}/memberCreator to get the action's creator instead. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | A comma-separated list of member fields to return, or 'all' for all fields. Valid fields include: avatarHash, avatarSource, bio, bioData, confirmed, email, fullName, gravatarHash, idBoards, idBoardsPinned, idOrganizations, idPremOrgsAdmin, initials, loginTypes, memberType, oneTimeMessagesDismissed, prefs, premiumFeatures, products, status, trophies, uploadedAvatarHash, url, username. | | `idAction` | string | Yes | The ID of the Trello action for which to retrieve the subject member. Note: This endpoint only works with actions that involve a member as the subject (e.g., addMemberToCard, removeMemberFromCard, addMemberToBoard). For actions without a member subject (e.g., createCard, createBoard), this will return 404. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Action Subject Member Field **Slug:** `TRELLO_GET_ACTIONS_MEMBER_BY_ID_ACTION_BY_FIELD` Retrieves a specific field of the member who was the subject of a Trello action. This is distinct from 'memberCreator' (who performed the action). Only works for actions that involve a member as the subject (e.g., addMemberToBoard, addMemberToCard, removeMemberFromCard). Returns a single field value for optimized data retrieval. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific member field to retrieve. Valid fields include: username, fullName, initials, avatarHash, avatarUrl, bio, email, url, status, memberType, confirmed. Note: 'id' field is not supported via this endpoint; use the parent action without field to get the full member object including id. | | `idAction` | string | Yes | The ID of the Trello action. The action must involve a member as its subject (e.g., addMemberToBoard, addMemberToCard). Actions like createCard or createList will return 404 as they don't have an associated 'member' (only a 'memberCreator'). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Fetch action member creator **Slug:** `TRELLO_GET_ACTIONS_MEMBER_CREATOR_BY_ID_ACTION` Retrieves details about the Trello member who created the action with the given `idAction`. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | A comma-separated list of member fields to retrieve, or 'all'. Valid fields include: avatarHash, avatarSource, bio, bioData, confirmed, email, fullName, gravatarHash, idBoards, idBoardsPinned, idOrganizations, idPremOrgsAdmin, initials, loginTypes, memberType, oneTimeMessagesDismissed, prefs, premiumFeatures, products, status, trophies, uploadedAvatarHash, url, username. | | `idAction` | string | Yes | The ID of the Trello action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get action member creator field **Slug:** `TRELLO_GET_ACTIONS_MEMBER_CREATOR_BY_ID_ACTION_BY_FIELD` Retrieves a specific field from the profile of the Trello member who created a given action. Use this to get targeted information like username, fullName, initials, avatarHash, or url from an action's creator. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field to retrieve from the member creator's profile. Valid fields include: avatarHash, avatarSource, bio, bioData, confirmed, fullName, gravatarHash, idBoards, idOrganizations, idPremOrgsAdmin, initials, loginTypes, memberType, oneTimeMessagesDismissed, prefs, premiumFeatures, products, status, trophies, uploadedAvatarHash, url, username. | | `idAction` | string | Yes | The ID of the Trello action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Fetch organization action by id **Slug:** `TRELLO_GET_ACTIONS_ORGANIZATION_BY_ID_ACTION` Fetches the organization details for a given Trello action, if the action has an associated organization. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies which fields of the organization resource to return. Use 'all' to fetch all available fields, or provide a comma-separated list of specific fields. Allowed fields include: billableMemberCount, desc, descData, displayName, idBoards, invitations, invited, logoHash, memberships, name, powerUps, prefs, premiumFeatures, products, url, website. | | `idAction` | string | Yes | The unique identifier of the Trello action for which organization details are being requested. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get action's organization field **Slug:** `TRELLO_GET_ACTIONS_ORGANIZATION_BY_ID_ACTION_BY_FIELD` 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'). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field of the organization to retrieve. Valid fields include 'name', 'displayName', 'desc', 'url', 'website', 'prefs', 'membersCount', 'logoHash', 'products', 'powerUps', 'billableMemberCount', and 'premiumFeatures'. Note: 'id' field is not supported via this endpoint. | | `idAction` | string | Yes | The unique identifier of the Trello action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get action's reaction by ID **Slug:** `TRELLO_GET_ACTIONS_REACTIONS_BY_ID` Retrieves detailed information about a specific reaction on a Trello action. Use when you need to get the member and emoji details for a specific reaction by its ID. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID of the reaction | | `emoji` | boolean | No | Whether to load the emoji as a nested resource. | | `member` | boolean | No | Whether to load the member as a nested resource. See Members Nested Resource documentation. | | `idAction` | string | Yes | The ID of the Action | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List action reactions **Slug:** `TRELLO_GET_ACTIONS_REACTIONS_BY_ID_ACTION` Tool to list reactions for a specific action. Use when you need to retrieve emoji reactions and the members who added them to an action. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `emoji` | boolean | No | Whether to load the emoji as a nested resource. | | `member` | boolean | No | Whether to load the member as a nested resource. See Members Nested Resource documentation. | | `idAction` | string | Yes | The ID of the action for which to retrieve reactions. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get batch **Slug:** `TRELLO_GET_BATCH` Executes multiple Trello API GET requests in a single batch operation for efficient bulk data retrieval. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `urls` | string | Yes | A comma-separated string of Trello API v1 GET routes to be executed in a single batch request. Each route must be relative to the `/1` Trello API base (e.g., `/cards/{idCard}`, `/boards/{idBoard}/lists`) and should not include the `/1` prefix in the individual routes. Trello typically limits this to a maximum of 10 routes per batch call. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board actions by id **Slug:** `TRELLO_GET_BOARDS_ACTIONS_BY_ID_BOARD` Retrieves actions (e.g., card creations, comments) for a Trello board by its ID, useful for activity tracking; the board must exist. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `page` | string | No | The page number of results to retrieve. Note: `page * limit` must be less than 1000. Used for pagination. | | `limit` | string | No | The maximum number of actions to return. Must be a number between 0 and 1000, inclusive. | | `since` | string | No | Return actions that occurred after this date, or use 'lastView' to get actions since the user last viewed the board. Can also be null. Dates should be in ISO 8601 format or a valid Trello date string. | | `before` | string | No | Return actions that occurred before this date. Can be null. Dates should be in ISO 8601 format or a valid Trello date string. | | `fields` | string | No | Specifies which action fields to return. Use 'all' for all fields, or provide a comma-separated list of field names. Supported fields include: data, date, idMemberCreator, or type. | | `filter` | string | No | A filter to return only specific types of actions. Use 'all' for all actions, or provide a comma-separated list of action types. Supported types include: addAttachmentToCard, addChecklistToCard, addMemberToBoard, addMemberToCard, addMemberToOrganization, addToOrganizationBoard, commentCard, convertToCardFromCheckItem, copyBoard, copyCard, copyCommentCard, createBoard, createCard, createList, createOrganization, deleteAttachmentFromCard, deleteBoardInvitation, deleteCard, deleteOrganizationInvitation, disablePowerUp, emailCard, enablePowerUp, makeAdminOfBoard, makeNormalMemberOfBoard, makeNormalMemberOfOrganization, makeObserverOfBoard, memberJoinedTrello, moveCardFromBoard, moveCardToBoard, moveListFromBoard, moveListToBoard, removeChecklistFromCard, removeFromOrganizationBoard, removeMemberFromCard, unconfirmedBoardInvitation, unconfirmedOrganizationInvitation, updateBoard, updateCard, updateCard:closed, updateCard:desc, updateCard:idList, updateCard:name, updateCheckItemStateOnCard, updateChecklist, updateList, updateList:closed, updateList:name, updateMember, or updateOrganization. | | `format` | string | No | The format of the returned actions. Valid options are 'count' (returns only the count of actions), 'list' (returns detailed actions), or 'minimal' (returns a minimal representation of actions). | | `member` | string | No | Includes member details in the action data if 'true'. | | `display` | string | No | Includes display-friendly information for entities in the response if 'true'. | | `idBoard` | string | Yes | The ID of the Trello board for which to retrieve actions. | | `entities` | string | No | Includes related entities (e.g., cards, lists, members) in the response if 'true'. | | `idModels` | string | No | A comma-separated list of model IDs (e.g., card IDs, list IDs) to filter actions by. Only actions related to these models will be returned. | | `memberCreator` | string | No | Includes details of the member who created the action if 'true'. | | `member_fields` | string | No | Specifies which fields of the member object to return if 'member' is true. Use 'all' for all member fields, or provide a comma-separated list. Supported fields include: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, or username. | | `memberCreator_fields` | string | No | Specifies which fields of the memberCreator object to return if 'memberCreator' is true. Use 'all' for all fields, or provide a comma-separated list. Supported fields include: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, or username. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board Power-Ups **Slug:** `TRELLO_GET_BOARDS_BOARD_PLUGINS_BY_ID` Tool to get the list of enabled Power-Ups on a Trello board. Use when you need to check which Power-Ups are currently active on a board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID of the Trello board. Valid formats: 24-character hexadecimal ID (e.g., '5abbe4b7ddc1b351ef961414') OR 8-character shortLink (e.g., 'TH6F0pTM'). Board names are NOT valid identifiers. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board stars by board ID **Slug:** `TRELLO_GET_BOARDS_BOARD_STARS_BY_ID_BOARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `filter` | string | No | Filter for board stars: 'mine' for the current user's stars (default), or 'none' for all stars on the board. | | `idBoard` | string | Yes | The unique identifier of the Trello board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board by id **Slug:** `TRELLO_GET_BOARDS_BY_ID_BOARD` Fetches comprehensive details for a specific Trello board by its ID; this is a read-only action. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cards` | string | No | Filters the cards to be returned. Valid values: 'all', 'closed', 'none', 'open', or 'visible'. | | `lists` | string | No | Filters the lists on the board to be returned. Valid values: 'all', 'closed', 'none', or 'open'. | | `fields` | string | No | Specifies the fields to return for the board object itself. Use 'all' or a comma-separated list. Valid fields: closed, dateLastActivity, dateLastView, desc, descData, idOrganization, invitations, invited, labelNames, memberships, name, pinned, powerUps, prefs, shortLink, shortUrl, starred, subscribed, url. | | `labels` | string | No | Filters the labels to be returned. Valid values: 'all' or 'none'. | | `actions` | string | No | Filters the actions to be returned. Specify 'all' or provide a comma-separated list of action types. Valid types include: addAttachmentToCard, addChecklistToCard, addMemberToBoard, addMemberToCard, addMemberToOrganization, addToOrganizationBoard, commentCard, convertToCardFromCheckItem, copyBoard, copyCard, copyCommentCard, createBoard, createCard, createList, createOrganization, deleteAttachmentFromCard, deleteBoardInvitation, deleteCard, deleteOrganizationInvitation, disablePowerUp, emailCard, enablePowerUp, makeAdminOfBoard, makeNormalMemberOfBoard, makeNormalMemberOfOrganization, makeObserverOfBoard, memberJoinedTrello, moveCardFromBoard, moveCardToBoard, moveListFromBoard, moveListToBoard, removeChecklistFromCard, removeFromOrganizationBoard, removeMemberFromCard, unconfirmedBoardInvitation, unconfirmedOrganizationInvitation, updateBoard, updateCard, updateCard:closed, updateCard:desc, updateCard:idList, updateCard:name, updateCheckItemStateOnCard, updateChecklist, updateList, updateList:closed, updateList:name, updateMember, or updateOrganization. | | `idBoard` | string | Yes | The unique identifier (ID) of the Trello board. Must be either a 24-character hexadecimal long-form ID (e.g., '68f9e68ace7e944875655da6') or an 8-character alphanumeric short-form ID (e.g., '8aBemlak'). Board names are NOT valid. Use TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER with idMember='me' to list boards and get their IDs. | | `members` | string | No | Filters the members of the board to be returned. Valid values: 'admins', 'all', 'none', 'normal', or 'owners'. | | `myPrefs` | string | No | Determines whether to include the current user's preferences for this board. Set to 'true' or 'false'. | | `boardStars` | string | No | Filters board stars. Valid values: 'mine' (stars by the current user) or 'none'. | | `checklists` | string | No | Filters board-level checklists to be returned. Valid values: 'all' or 'none'. | | `card_fields` | string | No | Specifies the fields to return for card objects. Use 'all' or a comma-separated list. Valid fields: badges, checkItemStates, closed, dateLastActivity, desc, descData, due, email, idAttachmentCover, idBoard, idChecklists, idLabels, idList, idMembers, idMembersVoted, idShort, labels, manualCoverAttachment, name, pos, shortLink, shortUrl, subscribed, url. | | `list_fields` | string | No | Specifies the fields to return for list objects. Use 'all' or a comma-separated list: closed, idBoard, name, pos, subscribed. | | `memberships` | string | No | Filters board memberships to return. Use 'all' or a comma-separated list of types: active, admin, deactivated, me, normal. | | `label_fields` | string | No | Specifies the fields to return for label objects. Use 'all' or a comma-separated list: color, idBoard, name, uses. | | `labels_limit` | string | No | The maximum number of labels to return, ranging from 0 to 1000. | | `organization` | string | No | Determines whether to include the organization object to which the board belongs. Set to 'true' or 'false'. | | `action_fields` | string | No | Specifies the fields to return for action objects. Use 'all' or a comma-separated list of fields: data, date, idMemberCreator, type. Defaults to 'all'. | | `action_member` | string | No | Determines whether to include the member object within actions. Set to 'true' or 'false'. | | `actions_limit` | string | No | The maximum number of actions to return, ranging from 0 to 1000. Defaults to 50 if not specified. | | `actions_since` | string | No | Filters actions to those that occurred after a specific date (ISO 8601 format), or 'lastView'. Use null for no date filtering. | | `card_stickers` | string | No | Determines whether to include stickers on cards. Set to 'true' or 'false'. | | `member_fields` | string | No | Specifies fields for member objects. Use 'all' or a comma-separated list. Valid fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | | `actions_format` | string | No | Specifies the format for returned actions. Valid values: 'count', 'list', or 'minimal'. Defaults to 'list' if not specified. | | `membersInvited` | string | No | Filters invited members of the board. Valid values: 'admins', 'all', 'none', 'normal', or 'owners'. | | `actions_display` | string | No | Determines whether to return display objects for actions. Set to 'true' or 'false'. | | `card_checklists` | string | No | Filters the checklists on cards to be returned. Valid values: 'all' or 'none'. | | `actions_entities` | string | No | Determines whether to return entity objects for actions. Set to 'true' or 'false'. | | `card_attachments` | string | No | Determines whether to include card attachments. Set to 'true', 'false', or 'cover' (for only card cover attachments). | | `checklist_fields` | string | No | Specifies fields for board-level checklist objects. Use 'all' or a comma-separated list: idBoard, idCard, name, pos. | | `memberships_member` | string | No | Determines whether to include member objects within memberships. Set to 'true' or 'false'. | | `organization_fields` | string | No | Specifies fields for the organization object. Use 'all' or a comma-separated list. Valid fields: billableMemberCount, desc, descData, displayName, idBoards, invitations, invited, logoHash, memberships, name, powerUps, prefs, premiumFeatures, products, url, website. | | `action_memberCreator` | string | No | Determines whether to include the member creator object within actions. Set to 'true' or 'false'. | | `action_member_fields` | string | No | Specifies the fields to return for member objects within actions. Use 'all' or a comma-separated list. Valid fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | | `membersInvited_fields` | string | No | Specifies fields for invited member objects. Use 'all' or a comma-separated list. Valid fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | | `card_attachment_fields` | string | No | Specifies the fields to return for card attachment objects. Use 'all' or a comma-separated list. Valid fields: bytes, date, edgeColor, idMember, isUpload, mimeType, name, previews, url. | | `organization_memberships` | string | No | Filters organization memberships to return. Use 'all' or a comma-separated list: active, admin, deactivated, me, normal. | | `memberships_member_fields` | string | No | Specifies fields for member objects within memberships. Use 'all' or a comma-separated list. Valid fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | | `action_memberCreator_fields` | string | No | Specifies the fields to return for member creator objects within actions. Use 'all' or a comma-separated list. Valid fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board field **Slug:** `TRELLO_GET_BOARDS_BY_ID_BOARD_BY_FIELD` Retrieves the value of a single, specified field from a Trello board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The name of the specific Trello board field to retrieve. | | `idBoard` | string | Yes | The ID of the Trello board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get cards by board ID **Slug:** `TRELLO_GET_BOARDS_CARDS_BY_ID_BOARD` Retrieves cards from an existing Trello board, allowing filtering and customization of fields for cards, attachments, and members. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | string | No | The maximum number of cards to return. Must be a number between 1 and 1000, inclusive. | | `since` | string | No | A date in ISO 8601 format. Only cards updated after this date will be returned. Use 'null' for no restriction. | | `before` | string | No | A date in ISO 8601 format. Only cards updated before this date will be returned. Use 'null' for no restriction. | | `fields` | string | No | A comma-separated list of card fields to be returned. Use 'all' to include all fields. Valid fields include: badges, checkItemStates, closed, dateLastActivity, desc, descData, due, email, idAttachmentCover, idBoard, idChecklists, idLabels, idList, idMembers, idMembersVoted, idShort, labels, manualCoverAttachment, name, pos, shortLink, shortUrl, subscribed, or url. If not specified, defaults to 'all' on the API side. | | `filter` | string | No | Filters the cards to return. Valid values are 'all', 'closed', 'none', 'open', or 'visible'. If not specified, defaults to 'visible' on the API side. | | `actions` | string | No | A comma-separated list of action types to be returned. Use 'all' to include all action types. Valid action types include: addAttachmentToCard, addChecklistToCard, addMemberToBoard, addMemberToCard, addMemberToOrganization, addToOrganizationBoard, commentCard, convertToCardFromCheckItem, copyBoard, copyCard, copyCommentCard, createBoard, createCard, createList, createOrganization, deleteAttachmentFromCard, deleteBoardInvitation, deleteCard, deleteOrganizationInvitation, disablePowerUp, emailCard, enablePowerUp, makeAdminOfBoard, makeNormalMemberOfBoard, makeNormalMemberOfOrganization, makeObserverOfBoard, memberJoinedTrello, moveCardFromBoard, moveCardToBoard, moveListFromBoard, moveListToBoard, removeChecklistFromCard, removeFromOrganizationBoard, removeMemberFromCard, unconfirmedBoardInvitation, unconfirmedOrganizationInvitation, updateBoard, updateCard, updateCard:closed, updateCard:desc, updateCard:idList, updateCard:name, updateCheckItemStateOnCard, updateChecklist, updateList, updateList:closed, updateList:name, updateMember, or updateOrganization. | | `idBoard` | string | Yes | The ID of the Trello board. Valid formats: 24-character hexadecimal ID (e.g., '60d5f2f1c8a8b4002b8f0123') OR 8-character shortLink (e.g., 'TH6F0pTM'). Human-readable board names or URL slugs (e.g., 'my-board', 'tech-jcorp') are NOT valid identifiers. In the URL 'trello.com/b/TH6F0pTM/my-board', 'TH6F0pTM' is the valid shortLink, while 'my-board' is just a slug and cannot be used. To find your board ID or shortLink: use TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER to list your boards, or look at the board URL in your browser. | | `members` | string | No | Determines whether members should be returned. Valid values are 'true' or 'false'. | | `stickers` | string | No | Determines whether stickers should be returned. Valid values are 'true' or 'false'. | | `checklists` | string | No | Determines which checklists to return. Valid values are 'all' or 'none'. If not specified, defaults to 'none' on the API side. | | `attachments` | string | No | Determines whether attachments should be returned. Can be 'true', 'false', or 'cover' (to return only card cover attachments). | | `member_fields` | string | No | A comma-separated list of member fields to be returned. Use 'all' to include all fields. Valid fields include: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, or username. If not specified, defaults to 'avatarHash,fullName,initials,username' on the API side. | | `checkItemStates` | string | No | Determines whether check item states should be returned. Valid values are 'true' or 'false'. | | `attachment_fields` | string | No | A comma-separated list of attachment fields to be returned. Use 'all' to include all fields. Valid fields include: bytes, date, edgeColor, idMember, isUpload, mimeType, name, previews, or url. If not specified, defaults to 'all' on the API side. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get cards by filter from board **Slug:** `TRELLO_GET_BOARDS_CARDS_BY_ID_BOARD_BY_FILTER` 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). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `filter` | string | Yes | Filter for retrieving cards. Valid values: 'all' (all cards), 'closed' (archived cards only), 'open' (non-archived cards), 'visible' (cards on non-archived lists). | | `idBoard` | string | Yes | Unique identifier of the Trello board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card from board **Slug:** `TRELLO_GET_BOARDS_CARDS_BY_ID_BOARD_BY_ID_CARD` 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 checklists. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Card fields to return ('all' or a comma-separated list: name, desc, due, idLabels). | | `idCard` | string | Yes | The full 24-character hexadecimal ID of the Trello card to retrieve. Note: shortLink values are not accepted for this endpoint. | | `labels` | string | No | Deprecated: Whether to return label data ('true' or 'false'); use `idLabels` in `fields` instead. | | `actions` | string | No | Actions to return ('all' or a comma-separated list of types like 'addAttachmentToCard', 'commentCard'). | | `idBoard` | string | Yes | The ID of the Trello board where the card is located. | | `members` | string | No | Whether to return member data for the card ('true' or 'false'). | | `checklists` | string | No | Checklists to return ('all' or 'none'). | | `attachments` | string | No | Specifies if and how attachments are returned ('true', 'false', or 'cover' for only card cover attachments). | | `action_fields` | string | No | Action fields to return ('all' or a comma-separated list: data, date, type). | | `actions_limit` | string | No | Maximum number of actions to return (0-1000). | | `member_fields` | string | No | Member fields to return ('all' or comma-separated list: avatarHash, fullName, username). | | `actions_display` | string | No | Whether to return display-friendly action data ('true' or 'false'). | | `checkItemStates` | string | No | Whether to return check item states for the card ('true' or 'false'). | | `actions_entities` | string | No | Whether to return entity information (e.g., boards, cards) for actions ('true' or 'false'). | | `checklist_fields` | string | No | Checklist fields to return ('all' or a comma-separated list: idBoard, name, pos). | | `attachment_fields` | string | No | Attachment fields to return ('all' or a comma-separated list like: bytes, date, name, url). | | `checkItemState_fields` | string | No | Fields for check item states ('all' or comma-separated: idCheckItem, state). | | `action_memberCreator_fields` | string | No | Fields for the member who created an action ('all' or comma-separated list: avatarHash, fullName, username). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board checklists **Slug:** `TRELLO_GET_BOARDS_CHECKLISTS_BY_ID_BOARD` 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 returned for each entity. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cards` | string | No | Determines which cards (and their checklists) are considered when fetching checklists. Valid values: 'all', 'closed', 'none', 'open', 'visible'. | | `fields` | string | No | Specifies fields of the checklists to return; 'all' or a comma-separated list (e.g., idBoard, idCard, name, pos). | | `filter` | string | No | Filters the checklists to be returned. Valid values: 'all' (all matching checklists) or 'none' (no checklists). | | `idBoard` | string | Yes | The ID of the Trello board from which to retrieve checklists. | | `checkItems` | string | No | Determines if check items (individual items within a checklist) are included in the response. Valid values: 'all', 'none'. | | `card_fields` | string | No | Specifies fields of associated cards to return; 'all' or a comma-separated list (e.g., name, idList, badges). | | `checkItem_fields` | string | No | Specifies fields of check items to return; 'all' or a comma-separated list (e.g., name, nameData, pos, state, type). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board custom fields **Slug:** `TRELLO_GET_BOARDS_CUSTOM_FIELDS` Tool to retrieve custom field definitions for a board. Use when you need to understand what custom fields are available on a board for metadata management. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID of the board | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Retrieve board deltas **Slug:** `TRELLO_GET_BOARDS_DELTAS_BY_ID_BOARD` Retrieves recent changes (deltas) for a Trello board by its ID, allowing tracking of modifications since a specified update sequence number (`ixLastUpdate`). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `tags` | string | Yes | Tag for filtering change types; use 'all' to subscribe to all changes on the board. | | `idBoard` | string | Yes | Unique identifier of the Trello board for which to retrieve deltas. | | `ixLastUpdate` | string | Yes | Sequence number of the last update received; use '-1' for all changes since creation, or the `ixLastUpdate` from a previous delta response for subsequent changes. Accepts string representations of numbers from -1 upwards. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board labels by ID **Slug:** `TRELLO_GET_BOARDS_LABELS_BY_ID_BOARD` Fetches labels for a specified Trello board, aiding in its organization or label management; this action does not detail per-card label usage. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | string | No | The maximum number of labels to be returned. Must be an integer between 0 and 1000, inclusive. Defaults to 50. | | `fields` | string | No | Determines which label fields to return. Use 'all' for all available fields, or a comma-separated list of specific fields from: color, idBoard, name, uses. Defaults to 'all'. | | `idBoard` | string | Yes | The unique 24-character hexadecimal identifier of the Trello board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get a board label **Slug:** `TRELLO_GET_BOARDS_LABELS_BY_ID_BOARD_BY_ID_LABEL` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | A comma-separated list of fields to include in the response for the label, or 'all' for all fields. Valid fields: 'color', 'idBoard', 'name', 'uses'. | | `idBoard` | string | Yes | The unique identifier of the Trello board. | | `idLabel` | string | Yes | The unique identifier of the label within the specified board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board's lists **Slug:** `TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD` Retrieves lists from a specified Trello board, with options to filter lists and include card details. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cards` | string | No | Determines which cards should be returned within the lists. Valid values are 'all', 'closed', 'none', or 'open'. | | `fields` | string | No | Specifies the fields of the lists to be returned. Use 'all' for all fields, or provide a comma-separated list of specific fields. Valid fields include: closed, idBoard, name, pos, or subscribed. | | `filter` | string | No | Filters the lists to be returned based on their status. Valid values are 'all', 'closed', 'none', or 'open'. | | `idBoard` | string | Yes | The ID of the Trello board. Valid formats: 24-character hexadecimal ID (e.g., '60d5f2f1c8a8b4002b8f0123') OR 8-character shortLink (e.g., 'TH6F0pTM'). Human-readable board names or URL slugs (e.g., 'my-board', 'tech-jcorp') are NOT valid identifiers. In the URL 'trello.com/b/TH6F0pTM/my-board', 'TH6F0pTM' is the valid shortLink, while 'my-board' is just a slug and cannot be used. To find your board ID or shortLink: use TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER to list your boards, or look at the board URL in your browser. | | `card_fields` | string | No | Specifies the fields of cards to be returned if the 'cards' parameter is not 'none'. Use 'all' for all fields, or provide a comma-separated list of specific fields. Valid fields include: badges, checkItemStates, closed, dateLastActivity, desc, descData, due, email, idAttachmentCover, idBoard, idChecklists, idLabels, idList, idMembers, idMembersVoted, idShort, labels, manualCoverAttachment, name, pos, shortLink, shortUrl, subscribed, or url. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board lists by filter (Deprecated) **Slug:** `TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD_BY_FILTER` DEPRECATED: Use TRELLO_BOARD_GET_LISTS_BY_ID_BOARD instead. Fetches lists by status from an accessible Trello board; card details for these lists require a separate call. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `filter` | string | Yes | Filter for retrieving lists: 'open' (active lists), 'closed' (archived lists), or 'all' (all lists, including archived). | | `idBoard` | string | Yes | The ID or shortLink of the Trello board from which to retrieve lists. Both full board IDs (24-character hex string) and shortLinks (8-character alphanumeric) are accepted. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board members **Slug:** `TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD` Retrieves members of a Trello board, with options to filter the list and select specific member fields to return. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Comma-separated list of member fields to return. Use 'all' for all fields. Valid field names: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | | `filter` | string | No | Filters the members returned. Valid values: 'admins' (board administrators), 'all' (all members), 'none' (no members), 'normal' (regular board members), 'owners' (board owners). | | `idBoard` | string | Yes | The unique identifier of the Trello board for which to retrieve members. | | `activity` | string | No | Indicates whether to include member activity. Accepts string values 'true' or 'false'. This option is effective only for Trello Premium organizations. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member cards from board **Slug:** `TRELLO_GET_BOARDS_MEMBERS_CARDS_BY_ID_BOARD_BY_ID_MEMBER` Retrieves cards for a member on a board, with options to customize returned fields and related data; member must have board access. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list` | string | No | Whether to include the list object (containing the card) with card data ('true' or 'false'). | | `board` | string | No | Whether to include the parent board object with card data ('true' or 'false'). | | `fields` | string | No | Card fields to return. 'all' or a comma-separated list (e.g., 'name,desc,due'). Refer to Trello API documentation for all available field names. | | `filter` | string | No | Filter cards by status. Valid values: 'all', 'closed', 'none', 'open', 'visible'. | | `actions` | string | No | Action types to include with the cards. 'all' or a comma-separated list (e.g., 'commentCard,createCard'). If omitted, no actions are returned. Refer to Trello API documentation for all available action types. | | `idBoard` | string | Yes | The unique identifier of the Trello board. | | `members` | string | No | Whether to include member objects with card data ('true' or 'false'). | | `idMember` | string | Yes | The unique identifier (24-character hex string) of the member whose cards are to be retrieved from the board. Use 'me' to refer to the authenticated user (automatically resolved to actual member ID). | | `checklists` | string | No | Which checklists to include with cards. Valid values: 'all' or 'none'. | | `attachments` | string | No | Whether to include attachments. Use 'true', 'false', or 'cover' (for card cover attachments only). | | `list_fields` | string | No | Fields for the list object, if 'list' is 'true'. 'all' or a comma-separated list (e.g., 'name,pos'). Available fields: closed, idBoard, name, pos, subscribed. | | `board_fields` | string | No | Fields for the board object, if 'board' is 'true'. 'all' or a comma-separated list (e.g., 'name,desc'). Refer to Trello API documentation for all available field names. | | `member_fields` | string | No | Fields for member objects, if 'members' is 'true'. 'all' or a comma-separated list (e.g., 'fullName,username'). Available fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | | `checkItemStates` | string | No | Whether to include check item states with card data ('true' or 'false'). | | `attachment_fields` | string | No | Fields for attachments, if 'attachments' is 'true'. 'all' or a comma-separated list (e.g., 'bytes,date,name'). Available fields: bytes, date, edgeColor, idMember, isUpload, mimeType, name, previews, url. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List board memberships **Slug:** `TRELLO_GET_BOARDS_MEMBERSHIPS_BY_ID_BOARD` Retrieves Trello board memberships (user roles and permissions) for auditing access or managing collaboration, returning only membership data and not other board content. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `filter` | string | No | Filters the types of memberships returned. Valid values are 'all' or a comma-separated list of: 'active', 'admin', 'deactivated', 'me', 'normal'. | | `member` | string | No | Determines whether to return member objects. Accepts string 'true' or 'false'. If not provided, the API's default behavior for including member details will apply. | | `idBoard` | string | Yes | The unique identifier of the Trello board. | | `member_fields` | string | No | Specifies the member fields to return. Valid values are 'all' or a comma-separated list of: 'avatarHash', 'bio', 'bioData', 'confirmed', 'fullName', 'idPremOrgsAdmin', 'initials', 'memberType', 'products', 'status', 'url', 'username'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board membership **Slug:** `TRELLO_GET_BOARDS_MEMBERSHIPS_BY_ID_BOARD_BY_ID_MEMBERSHIP` Retrieves a specific membership on a Trello board by its ID, optionally including member details. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `member` | string | No | Set to 'true' to return the full member object. If 'false' or not provided, Trello's default for member details (typically minimal) applies. | | `idBoard` | string | Yes | The ID of the Trello board. | | `idMembership` | string | Yes | The ID of the membership to retrieve. | | `member_fields` | string | No | Comma-separated list of member fields to return when 'member' is 'true' (e.g., 'avatarHash,fullName'), or 'all' for all fields. Valid fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. Defaults to API behavior if not specified. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get invited board members **Slug:** `TRELLO_GET_BOARDS_MEMBERS_INVITED_BY_ID_BOARD` Retrieves a list of members invited to a specific Trello board who have not yet joined. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies the fields to return for invited members. Use 'all' for all fields, or provide a comma-separated list. Allowed fields: avatarHash, avatarSource, bio, bioData, confirmed, email, fullName, gravatarHash, idBoards, idBoardsPinned, idOrganizations, idPremOrgsAdmin, initials, loginTypes, memberType, oneTimeMessagesDismissed, prefs, premiumFeatures, products, status, trophies, uploadedAvatarHash, url, username. | | `idBoard` | string | Yes | The unique identifier of the Trello board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Retrieve invited board member field **Slug:** `TRELLO_GET_BOARDS_MEMBERS_INVITED_BY_ID_BOARD_BY_FIELD` Retrieves a specific field (e.g., email, username) for members who have been invited to a Trello board but have not yet joined. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific attribute to retrieve for the members invited to the board. This typically refers to a common member property. | | `idBoard` | string | Yes | The unique identifier of the Trello board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get my board preferences **Slug:** `TRELLO_GET_BOARDS_MY_PREFS_BY_ID_BOARD` Retrieves the authenticated user's preferences for a specific Trello board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idBoard` | string | Yes | The ID of the Trello board for which to retrieve the current user's preferences. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board organization **Slug:** `TRELLO_GET_BOARDS_ORGANIZATION_BY_ID_BOARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies the fields to be returned for the organization. Use 'all' to retrieve all available fields, or provide a comma-separated list of specific fields. Valid fields include: 'billableMemberCount', 'desc', 'descData', 'displayName', 'idBoards', 'invitations', 'invited', 'logoHash', 'memberships', 'name', 'powerUps', 'prefs', 'premiumFeatures', 'products', 'url', or 'website'. | | `idBoard` | string | Yes | The ID of the Trello board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board organization field **Slug:** `TRELLO_GET_BOARDS_ORGANIZATION_BY_ID_BOARD_BY_FIELD` Retrieves a specific field from the organization associated with a Trello board, useful for obtaining targeted details without fetching the entire organization object. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific organization field to retrieve. Valid fields include: 'name' (organization name/slug), 'displayName' (human-readable display name), 'desc' (description), 'url' (organization URL), 'website' (organization website), 'logoHash' (logo identifier), 'products' (enabled products), 'powerUps' (enabled power-ups), 'idBoards' (board IDs), 'memberships' (member list), 'premiumFeatures' (premium features list), 'prefs' (preferences), 'teamType', 'billableMemberCount', 'descData', 'invitations', 'invited'. Note: 'id' is not supported through this endpoint. | | `idBoard` | string | Yes | The ID of the Trello board. The board must belong to an organization/workspace to retrieve organization fields. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board's Power-Ups **Slug:** `TRELLO_GET_BOARDS_PLUGINS_BY_ID_BOARD` Retrieves Power-Ups (plugins) enabled on a Trello board. Use to view board extensions and integrations. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID of the Trello board. Valid formats: 24-character hexadecimal ID (e.g., '5abbe4b7ddc1b351ef961414') OR 8-character shortLink (e.g., 'TH6F0pTM'). Human-readable board names are NOT valid identifiers. | | `filter` | string ("enabled" | "available") | No | Filter to specify which Power-Ups to return. 'enabled' returns only Power-Ups currently enabled on the board. 'available' returns all Power-Ups available to enable. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card actions by id **Slug:** `TRELLO_GET_CARDS_ACTIONS_BY_ID_CARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `page` | string | No | The page number of results to retrieve, starting from 0. Used for pagination. Note: `page * limit` must be less than 1000. | | `limit` | string | No | The maximum number of actions to return. Must be a number between 0 and 1000. | | `since` | string | No | A date in ISO 8601 format (e.g., '2023-01-15T10:00:00Z'), 'null', or 'lastView'. Returns actions that occurred after this date/event. 'lastView' refers to the time the user last viewed the card. | | `before` | string | No | A date in ISO 8601 format (e.g., '2023-12-31T23:59:59Z'), or 'null'. Returns actions that occurred before this date. | | `fields` | string | No | A comma-separated list of fields to include for each action, or 'all'. Valid fields: data, date, idMemberCreator, type. | | `filter` | string | No | A comma-separated list of action types to filter by (e.g., 'commentCard,updateCard:idList'), or 'all'. Valid action types are: addAttachmentToCard, addChecklistToCard, addMemberToBoard, addMemberToCard, addMemberToOrganization, addToOrganizationBoard, commentCard, convertToCardFromCheckItem, copyBoard, copyCard, copyCommentCard, createBoard, createCard, createList, createOrganization, deleteAttachmentFromCard, deleteBoardInvitation, deleteCard, deleteOrganizationInvitation, disablePowerUp, emailCard, enablePowerUp, makeAdminOfBoard, makeNormalMemberOfBoard, makeNormalMemberOfOrganization, makeObserverOfBoard, memberJoinedTrello, moveCardFromBoard, moveCardToBoard, moveListFromBoard, moveListToBoard, removeChecklistFromCard, removeFromOrganizationBoard, removeMemberFromCard, unconfirmedBoardInvitation, unconfirmedOrganizationInvitation, updateBoard, updateCard, updateCard:closed, updateCard:desc, updateCard:idList, updateCard:name, updateCheckItemStateOnCard, updateChecklist, updateList, updateList:closed, updateList:name, updateMember, or updateOrganization. | | `format` | string | No | The format of the response. 'list' returns a list of actions, 'minimal' returns a minimal list of actions, and 'count' returns only the total number of actions. | | `idCard` | string | Yes | The ID or shortLink of the card for which to retrieve actions. | | `member` | string | No | Determines whether to include details of the member who performed the action. Provide as a string 'true' or 'false'. | | `display` | string | No | Determines whether to return display-related information for the actions. Provide as a string 'true' or 'false'. | | `entities` | string | No | Determines whether to return information about entities (e.g., comments, checklists) associated with the actions. Provide as a string 'true' or 'false'. | | `idModels` | string | No | A comma-separated list of model IDs. If provided, only actions related to these specific model IDs (e.g., a specific checklist item ID if an action is 'updateCheckItemStateOnCard') will be returned. | | `memberCreator` | string | No | Determines whether to include details of the member who created the action (the action's author). Provide as a string 'true' or 'false'. | | `member_fields` | string | No | A comma-separated list of fields to return for the member object, if 'member' is 'true'. Valid fields include: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, or username. Use 'all' to retrieve all fields. | | `memberCreator_fields` | string | No | A comma-separated list of fields to return for the memberCreator object, if 'memberCreator' is 'true'. Valid fields include: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, or username. Use 'all' to retrieve all fields. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card attachments **Slug:** `TRELLO_GET_CARDS_ATTACHMENTS_BY_ID_CARD` Retrieves attachments for a Trello card. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Comma-separated list of fields to return (e.g., bytes, date, edgeColor, idMember, isUpload, mimeType, name, previews, url), or 'all'. | | `filter` | string | No | Filter for attachments: 'cover' for card cover, 'true' for all, or 'false' for non-cover (behavior can vary). | | `idCard` | string | Yes | The ID or shortLink of the Trello card from which to retrieve attachments. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get specific card attachment **Slug:** `TRELLO_GET_CARDS_ATTACHMENTS_BY_ID_CARD_BY_ID_ATTACHMENT` Retrieves a specific attachment from a Trello card by card ID and attachment ID. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies the fields to be returned for the attachment. Use 'all' to retrieve all available fields, or provide a comma-separated list of specific fields. Valid fields include: bytes, date, edgeColor, fileName, idMember, isMalicious, isUpload, mimeType, name, pos, previews, url. | | `idCard` | string | Yes | The unique identifier or the short link of the Trello card from which to retrieve the attachment. | | `idAttachment` | string | Yes | The unique identifier of the specific attachment to be retrieved from the card. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board by card id **Slug:** `TRELLO_GET_CARDS_BOARD_BY_ID_CARD` Fetches detailed information about the Trello board to which a specific, existing, and accessible card belongs, using the card's ID or short link. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies the fields of the board to be returned. Use 'all' to retrieve all available fields, or provide a comma-separated list of specific fields. Allowed fields include: closed, dateLastActivity, dateLastView, desc, descData, idOrganization, invitations, invited, labelNames, memberships, name, pinned, powerUps, prefs, shortLink, shortUrl, starred, subscribed, and url. | | `idCard` | string | Yes | The ID or short link of the Trello card for which to retrieve board information. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board field by card ID **Slug:** `TRELLO_GET_CARDS_BOARD_BY_ID_CARD_BY_FIELD` Retrieves a specific field from the board associated with a given Trello card. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | Field from the card's parent board to retrieve. One of: `name`, `desc`, `descData`, `closed`, `idMemberCreator`, `idOrganization`, `pinned`, `url`, `shortUrl`, `prefs`, `labelNames`, `starred`, `limits`, `memberships`, `enterpriseOwned`. | | `idCard` | string | Yes | ID or short link of the card. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card by ID **Slug:** `TRELLO_GET_CARDS_BY_ID_CARD` Retrieves a Trello card by its ID or shortlink, with options to include related data like actions, attachments, members, and checklists. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list` | string | No | Include data for the card's list. Use 'true' or 'false'. | | `board` | string | No | Include data for the card's board. Use 'true' or 'false'. | | `fields` | string | No | Fields for the card: 'all' or comma-separated (e.g., 'name,desc'). Valid: badges, checkItemStates, closed, dateLastActivity, desc, descData, due, email, idAttachmentCover, idBoard, idChecklists, idLabels, idList, idMembers, idMembersVoted, idShort, labels, manualCoverAttachment, name, pos, shortLink, shortUrl, subscribed, url. | | `idCard` | string | Yes | The unique identifier or shortlink of the Trello card. Must be either a 24-character hexadecimal ID (e.g., '5abbe4b7ddc1b351ef961414') or an 8-character alphanumeric shortlink (e.g., 'H0TZyzbK'). Short numeric strings like '6514' are not valid. | | `actions` | string | No | Actions to return: 'all' or a comma-separated list of types (e.g., 'addAttachmentToCard', 'commentCard', 'updateCard'). For a complete list of types, consult the Trello API documentation. | | `members` | string | No | Include member data. Use 'true' or 'false'. | | `stickers` | string | No | Include sticker data. Use 'true' or 'false'. | | `checklists` | string | No | Include checklists: 'all' or 'none'. | | `attachments` | string | No | Include attachments: 'true' (all), 'false' (none), or 'cover' (card cover only). | | `list_fields` | string | No | Fields for the list: 'all' or comma-separated (e.g., 'name,pos'). Valid: closed, idBoard, name, pos, subscribed. | | `board_fields` | string | No | Fields for the board: 'all' or comma-separated (e.g., 'name,desc'). Valid: closed, dateLastActivity, dateLastView, desc, descData, idOrganization, invitations, invited, labelNames, memberships, name, pinned, powerUps, prefs, shortLink, shortUrl, starred, subscribed, url. | | `membersVoted` | string | No | Include data for members who voted. Use 'true' or 'false'. | | `action_fields` | string | No | Fields for actions: 'all' or comma-separated (e.g., 'data,date'). Valid: data, date, idMemberCreator, type. | | `actions_limit` | string | No | Maximum actions to return (0-1000). | | `member_fields` | string | No | Fields for members: 'all' or comma-separated (e.g., 'avatarHash,fullName'). Valid: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | | `sticker_fields` | string | No | Fields for stickers: 'all' or comma-separated (e.g., 'image,left'). Valid: image, imageScaled, imageUrl, left, rotate, top, zIndex. | | `actions_display` | string | No | Return display-friendly action data. Use 'true' or 'false'. | | `checkItemStates` | string | No | Include check item states. Use 'true' or 'false'. | | `actions_entities` | string | No | Include entities (e.g., card, board, member) for actions. Use 'true' or 'false'. | | `checklist_fields` | string | No | Fields for checklists: 'all' or comma-separated (e.g., 'idBoard,name'). Valid: idBoard, idCard, name, pos. | | `attachment_fields` | string | No | Fields for attachments: 'all' or comma-separated (e.g., 'bytes,date'). Valid: bytes, date, edgeColor, idMember, isUpload, mimeType, name, previews, url. | | `memberVoted_fields` | string | No | Fields for members who voted: 'all' or comma-separated (e.g., 'avatarHash,fullName'). Valid: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | | `checkItemState_fields` | string | No | Fields for check item states: 'all' or comma-separated (e.g., 'idCheckItem,state'). Valid: idCheckItem, state. | | `action_memberCreator_fields` | string | No | Fields for the action creator: 'all' or comma-separated (e.g., 'avatarHash,fullName'). Valid: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card field by id **Slug:** `TRELLO_GET_CARDS_BY_ID_CARD_BY_FIELD` Retrieves the value of a single, specified field from a Trello card. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field to retrieve from the card. Valid values include standard card fields like 'name', 'desc', 'due', 'closed', 'idBoard', 'idList', 'pos', 'shortUrl', 'url', 'subscribed', as well as custom fields. | | `idCard` | string | Yes | The ID or short link of the Trello card. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card check item **Slug:** `TRELLO_GET_CARDS_CHECK_ITEM` Tool to retrieve a specific checkItem on a card. Use when you need to check the status or details of a specific item in a card's checklist. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID of the Card | | `fields` | string | No | Determines which fields to include in the response. Specify 'all' or a comma-separated list of: 'name', 'nameData', 'pos', 'state', 'type', 'due', 'dueReminder', 'idMember'. | | `idCheckItem` | string | Yes | The ID of the checkitem | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card check item states **Slug:** `TRELLO_GET_CARDS_CHECK_ITEM_STATES_BY_ID_CARD` Gets the completed checklist items on a Trello card. Note: This endpoint only returns check items marked as 'complete', not incomplete items. Returns item IDs and states, not full checklist or card details. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies the fields to return for each check item state. Use 'all' to retrieve all available fields, or provide a comma-separated list of specific fields. Valid fields are 'idCheckItem' and 'state'. | | `idCard` | string | Yes | The unique identifier (ID) or short link of the Trello card for which to retrieve check item states. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card checklists by ID **Slug:** `TRELLO_GET_CARDS_CHECKLISTS_BY_ID_CARD` Retrieves all checklists, including their check items, for a Trello card specified by its ID or shortlink, if the card exists and is accessible. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cards` | string | No | Filters which cards' checklists are retrieved. Valid values: 'all' (all cards), 'closed' (closed cards), 'none' (no cards, default), 'open' (open cards), or 'visible' (cards visible to the user). | | `fields` | string | No | Specifies the fields to return for each checklist. Use 'all' for all fields (default), or provide a comma-separated list of desired fields. Available fields: 'idBoard', 'idCard', 'name', 'pos'. | | `filter` | string | No | Filters which checklists are returned. Valid values: 'all' (default, returns all checklists) or 'none' (returns no checklists). | | `idCard` | string | Yes | The ID or shortlink of the Trello card. | | `checkItems` | string | No | Filters the check items to be returned within each checklist. Valid values: 'all' (default) or 'none'. | | `card_fields` | string | No | Specifies the fields to return for associated card objects. Use 'all' for all fields (default), or provide a comma-separated list of desired fields. Available fields: 'badges', 'checkItemStates', 'closed', 'dateLastActivity', 'desc', 'descData', 'due', 'email', 'idAttachmentCover', 'idBoard', 'idChecklists', 'idLabels', 'idList', 'idMembers', 'idMembersVoted', 'idShort', 'labels', 'manualCoverAttachment', 'name', 'pos', 'shortLink', 'shortUrl', 'subscribed', 'url'. | | `checkItem_fields` | string | No | Specifies the fields to return for each check item. Use 'all' for all fields, or provide a comma-separated list of desired fields (default is 'name,nameData,pos,state'). Available fields: 'name', 'nameData', 'pos', 'state', 'type'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card custom field items **Slug:** `TRELLO_GET_CARDS_CUSTOM_FIELD_ITEMS_BY_ID_CARD` Tool to retrieve a card's customFieldItems array. Use when you need structured metadata from custom fields for automation. Must be called per card — no bulk endpoint exists. Returns an empty array if no custom fields are populated on the card. Power-Up data (e.g., time tracking) is not included in customFieldItems. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idCard` | string | Yes | The ID or short link of the Trello card. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get list by card ID **Slug:** `TRELLO_GET_CARDS_LIST_BY_ID_CARD` Gets the Trello list to which a specified card (which must exist) belongs. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Fields of the list to return. Use 'all' for all fields, or a comma-separated list of specific field names (e.g., 'name,pos'). Allowed: 'closed', 'idBoard', 'name', 'pos', 'subscribed'. | | `idCard` | string | Yes | The card's unique ID (typically 24 characters) or its shortLink (e.g., 'AbCdEfGh' from the card URL). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card list field **Slug:** `TRELLO_GET_CARDS_LIST_BY_ID_CARD_BY_FIELD` Fetches a specific field from the Trello list that a given card belongs to. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field to retrieve from the list associated with the card. Common valid Trello list fields include `name`, `closed` (status), `pos` (position), `idBoard`, or `subscribed`. | | `idCard` | string | Yes | The ID or short link of the Trello card. The list associated with this card will be targeted. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card members **Slug:** `TRELLO_GET_CARDS_MEMBERS_BY_ID_CARD` Retrieves members of a Trello card, identified by its ID or shortLink, allowing customization of which member fields are returned. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Comma-separated list of member fields to return (e.g., 'avatarHash,fullName,username'), or 'all' for all fields. Valid fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | | `idCard` | string | Yes | The ID or shortLink of the Trello card from which to retrieve members. Card IDs are typically 24-character hexadecimal strings. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card members voted **Slug:** `TRELLO_GET_CARDS_MEMBERS_VOTED_BY_ID_CARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Comma-separated list of member fields to return, or 'all'. Valid fields: `avatarHash`, `bio`, `bioData`, `confirmed`, `fullName`, `idPremOrgsAdmin`, `initials`, `memberType`, `products`, `status`, `url`, `username`. | | `idCard` | string | Yes | The ID or short link of the Trello card. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card plugin data **Slug:** `TRELLO_GET_CARDS_PLUGIN_DATA_BY_ID` Tool to retrieve any shared pluginData on a card. Use when you need to access data stored by Trello Power-Ups or plugins for a specific card. Note: Forge and OAuth2 apps cannot access this resource. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID of the Card | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card stickers by ID card **Slug:** `TRELLO_GET_CARDS_STICKERS_BY_ID_CARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Sticker fields to return. Either 'all' for all fields, or a comma-separated list of specific field names (e.g., `image`, `imageScaled`, `imageUrl`, `left`, `rotate`, `top`, `zIndex`). | | `idCard` | string | Yes | The ID or shortLink of the Trello card from which to retrieve stickers. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get card sticker by id **Slug:** `TRELLO_GET_CARDS_STICKERS_BY_ID_CARD_BY_ID_STICKER` Call this action to retrieve detailed properties (like image, position, rotation) of a specific sticker on a Trello card. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies sticker fields to return (e.g., 'image,top,left'). Allowed: 'image', 'imageScaled', 'imageUrl', 'left', 'rotate', 'top', 'zIndex'. Use 'all' (default) to retrieve all fields. | | `idCard` | string | Yes | The ID or shortLink of the Trello card to which the sticker belongs. | | `idSticker` | string | Yes | The ID of the sticker to retrieve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get check item by id **Slug:** `TRELLO_GET_CHECK_ITEM_BY_ID` Retrieves a specific check item from a checklist using the checklist ID and check item ID. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Determines which fields to include in the response. Specify 'all' or a comma-separated list of: 'name', 'nameData', 'pos', 'state', or 'type'. | | `idCheckItem` | string | Yes | The ID of the check item to retrieve. | | `idChecklist` | string | Yes | The ID of the checklist containing the check item. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board for a checklist **Slug:** `TRELLO_GET_CHECKLISTS_BOARD_BY_ID_CHECKLIST` Retrieves the Trello board a specific checklist belongs to, using the checklist ID. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Comma-separated list of board fields to return (e.g., 'name,desc') or 'all'. Valid fields: closed, dateLastActivity, dateLastView, desc, descData, idOrganization, invitations, invited, labelNames, memberships, name, pinned, powerUps, prefs, shortLink, shortUrl, starred, subscribed, url. | | `idChecklist` | string | Yes | ID of the Trello checklist. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get checklist's board field **Slug:** `TRELLO_GET_CHECKLISTS_BOARD_BY_ID_CHECKLIST_BY_FIELD` Retrieves a specified `field` (e.g., 'name', 'desc') from the Trello board associated with the given `idChecklist`. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The board field to retrieve (e.g., 'name', 'desc', 'url', 'idOrganization', 'shortUrl'). | | `idChecklist` | string | Yes | The ID of the checklist. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get checklist by ID **Slug:** `TRELLO_GET_CHECKLISTS_BY_ID_CHECKLIST` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cards` | string | No | Determines whether to return card information for the checklist. Valid values: 'all', 'closed', 'none', 'open', 'visible'. Default: 'none'. | | `fields` | string | No | Specifies which checklist fields to return. Use 'all' for all fields, or provide a comma-separated list of: 'idBoard', 'idCard', 'name', 'pos'. Default: 'all'. | | `checkItems` | string | No | Determines whether to return check items for the checklist. Valid values: 'all', 'none'. Default: 'all'. | | `card_fields` | string | No | Specifies which card fields to return if 'cards' is not 'none'. Use 'all' for all fields, or provide a comma-separated list of desired fields. Available fields: 'badges', 'checkItemStates', 'closed', 'dateLastActivity', 'desc', 'descData', 'due', 'email', 'idAttachmentCover', 'idBoard', 'idChecklists', 'idLabels', 'idList', 'idMembers', 'idMembersVoted', 'idShort', 'labels', 'manualCoverAttachment', 'name', 'pos', 'shortLink', 'shortUrl', 'subscribed', 'url'. Default: 'all'. | | `idChecklist` | string | Yes | The unique identifier of the checklist to retrieve. | | `checkItem_fields` | string | No | Specifies which fields of the check items to return if 'checkItems' is 'all'. Accepts 'all' or a comma-separated list of: 'name', 'nameData', 'pos', 'state', 'type'. Default parameter value is the string 'name, nameData, pos and state', which effectively returns the name, nameData, position, and state of check items. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get checklist field **Slug:** `TRELLO_GET_CHECKLISTS_BY_ID_CHECKLIST_BY_FIELD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The name of the checklist field whose value is to be retrieved. Valid fields include: 'name' (checklist name), 'idCard' (ID of the card it belongs to), 'idBoard' (ID of the board), 'pos' (position), and 'checkItems' (list of check items). | | `idChecklist` | string | Yes | The unique identifier of the Trello checklist. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get checklist cards **Slug:** `TRELLO_GET_CHECKLISTS_CARDS_BY_ID_CHECKLIST` Retrieves cards associated with a specific, valid Trello checklist ID, allowing for filtering and customization of card and related entity data fields. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | string | No | Maximum number of cards to return (1-1000, e.g., '50'). | | `since` | string | No | Return cards updated on or after this date/time (ISO 8601 format or 'null'). | | `before` | string | No | Return cards updated on or before this date/time (ISO 8601 format or 'null'). | | `fields` | string | No | Card fields to return (e.g., 'name,desc,due'). Comma-separated list or 'all'. | | `filter` | string | No | Filter cards by status ('all', 'closed', 'none', 'open'). | | `actions` | string | No | Action types to return for each card (e.g., 'all', 'commentCard,createCard'). Comma-separated list or 'all'. | | `members` | string | No | Whether to include member data on cards ('true' or 'false'). | | `stickers` | string | No | Whether to include sticker data on cards ('true' or 'false'). | | `checklists` | string | No | Whether to include checklist data (beyond the main one) on the cards ('all' or 'none'). | | `attachments` | string | No | Whether to include attachments: 'true' for all, 'false' to omit, or 'cover' for card cover attachments. | | `idChecklist` | string | Yes | The ID of the checklist to retrieve cards from. | | `member_fields` | string | No | Member fields to return (e.g., 'fullName,username,bio'). Comma-separated list or 'all'. | | `checkItemStates` | string | No | Whether to include check item states on cards ('true' or 'false'). | | `attachment_fields` | string | No | Attachment fields to return (e.g., 'name,url,bytes'). Comma-separated list or 'all'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get checklist items by ID **Slug:** `TRELLO_GET_CHECKLISTS_CHECK_ITEMS_BY_ID_CHECKLIST` Retrieves all check items from a Trello checklist. Returns item details including name, position, completion state, and optionally due dates and assigned members. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Comma-separated list of fields to return for each check item, or 'all' for all fields. Available fields: name, nameData, pos, state, type, due, dueReminder, idMember. | | `filter` | string | No | Filter which check items to return. 'all' returns all items, 'none' returns no items. | | `idChecklist` | string | Yes | The unique identifier (24-character hex string) of the Trello checklist to retrieve items from. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board by label ID **Slug:** `TRELLO_GET_LABELS_BOARD_BY_ID_LABEL` Retrieves the Trello board to which a given, valid Trello label ID (`idLabel`) belongs. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies the fields of the board to be returned, as a comma-separated list of specific field names. Allowed values for the list include: 'closed', 'dateLastActivity', 'dateLastView', 'desc', 'descData', 'idOrganization', 'invitations', 'invited', 'labelNames', 'memberships', 'name', 'pinned', 'powerUps', 'prefs', 'shortLink', 'shortUrl', 'starred', 'subscribed', 'url'. | | `idLabel` | string | Yes | The unique identifier of the Trello label. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Retrieve board field by label id **Slug:** `TRELLO_GET_LABELS_BOARD_BY_ID_LABEL_BY_FIELD` Retrieves a specified `field` (e.g., 'name', 'url') from the Trello board associated with a given `idLabel`. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field of the board to retrieve. Valid fields include: 'closed', 'dateLastActivity', 'dateLastView', 'desc', 'descData', 'idOrganization', 'invitations', 'invited', 'labelNames', 'memberships', 'name', 'pinned', 'powerUps', 'prefs', 'shortLink', 'shortUrl', 'starred', 'subscribed', 'url'. Note: 'id' is not supported by this endpoint. | | `idLabel` | string | Yes | The unique 24-character hexadecimal ID of the Trello label (e.g., '65f08f79247db2008a033901'). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get label by id **Slug:** `TRELLO_GET_LABELS_BY_ID_LABEL` Retrieves detailed information for a specific Trello label by its ID, allowing selection of specific fields to return. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Fields to return for the label. Allowed: `color`, `idBoard`, `name`. | | `idLabel` | string | Yes | The unique identifier of the Trello label to retrieve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get list actions by ID **Slug:** `TRELLO_GET_LISTS_ACTIONS_BY_ID_LIST` Retrieves actions (like card movements or comments, newest first) for a Trello list by its ID, to track history or create activity logs. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `page` | string | No | Page number for pagination (0-indexed). Note: `page * limit` must be < 1000. | | `limit` | string | No | Maximum actions per page (0-1000). | | `since` | string | No | Return actions created after this date (ISO 8601, Trello date string, or 'lastView'). Null or unspecified means no start date filter. | | `before` | string | No | Return actions created before this date (ISO 8601 or Trello date string). Null or unspecified means no end date filter. | | `fields` | string | No | Action fields to return. Use 'all' or a comma-separated list (e.g., data, date). Valid fields: data, date, idMemberCreator, or type. | | `filter` | string | No | Filters actions by type. Use 'all' or a comma-separated list of types (e.g., commentCard, createCard). Valid types: addAttachmentToCard, addChecklistToCard, addMemberToBoard, addMemberToCard, addMemberToOrganization, addToOrganizationBoard, commentCard, convertToCardFromCheckItem, copyBoard, copyCard, copyCommentCard, createBoard, createCard, createList, createOrganization, deleteAttachmentFromCard, deleteBoardInvitation, deleteCard, deleteOrganizationInvitation, disablePowerUp, emailCard, enablePowerUp, makeAdminOfBoard, makeNormalMemberOfBoard, makeNormalMemberOfOrganization, makeObserverOfBoard, memberJoinedTrello, moveCardFromBoard, moveCardToBoard, moveListFromBoard, moveListToBoard, removeChecklistFromCard, removeFromOrganizationBoard, removeMemberFromCard, unconfirmedBoardInvitation, unconfirmedOrganizationInvitation, updateBoard, updateCard, updateCard:closed, updateCard:desc, updateCard:idList, updateCard:name, updateCheckItemStateOnCard, updateChecklist, updateList, updateList:closed, updateList:name, updateMember, or updateOrganization. | | `format` | string | No | Format of returned actions. Valid: 'count', 'list', 'minimal'. | | `idList` | string | Yes | The ID of the Trello list for which to retrieve actions. | | `member` | string | No | Whether to include the member object (user who performed the action). If None, Trello's default applies. | | `display` | string | No | Whether to include displayable information (e.g., human-readable text) for actions. If None, Trello's default (typically false) is used. | | `entities` | string | No | Whether to include related entities. If None, Trello's default (typically false) is used. | | `idModels` | string | No | Comma-separated model IDs (e.g., card IDs) to filter actions. If None, no model ID filter is applied. | | `memberCreator` | string | No | Whether to include the memberCreator object (action creator). If None, Trello's default applies. | | `member_fields` | string | No | Fields for the member object if 'member' is true. Use 'all' or a comma-separated list. Valid fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, or username. | | `memberCreator_fields` | string | No | Fields for memberCreator object if 'memberCreator' is true. Use 'all' or a comma-separated list. Valid fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, or username. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board by list ID **Slug:** `TRELLO_GET_LISTS_BOARD_BY_ID_LIST` Retrieves the board to which a specific Trello list belongs. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Board fields to return, comma-separated. Use 'all' for all fields. Valid fields: closed, dateLastActivity, dateLastView, desc, descData, idOrganization, invitations, invited, labelNames, memberships, name, pinned, powerUps, prefs, shortLink, shortUrl, starred, subscribed, url. | | `idList` | string | Yes | The unique identifier of the Trello list for which to retrieve the parent board information. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get board field by list ID **Slug:** `TRELLO_GET_LISTS_BOARD_BY_ID_LIST_BY_FIELD` Retrieves a specific field (e.g., 'name', 'desc', 'url') from the Trello board associated with a given list ID. Useful when you only have a list ID and need board information without fetching the full board object. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field of the board to retrieve. Valid fields include: name, desc, descData, closed, idMemberCreator, idOrganization, pinned, url, shortUrl, prefs, labelNames, starred, memberships, shortLink, subscribed, dateLastActivity, dateLastView, invited, powerUps, invitations. | | `idList` | string | Yes | The unique identifier of the Trello list. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get list by ID **Slug:** `TRELLO_GET_LISTS_BY_ID_LIST` Retrieves a Trello list by its unique ID, optionally including details for its cards and parent board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `board` | string | No | Determines whether the board object the list belongs to is returned. Set to 'true' to include board details or 'false' to omit them. | | `cards` | string | No | Determines whether cards are returned as part of the list data. Valid values are 'all', 'closed', 'none', or 'open'. | | `fields` | string | No | Specifies the fields for the list itself to be returned. Valid values are 'all' or a comma-separated list of list fields: closed, idBoard, name, pos, or subscribed. | | `idList` | string | Yes | The ID of the Trello list to retrieve. | | `card_fields` | string | No | Specifies the fields for cards to be returned if 'cards' is not 'none'. Valid values are 'all' or a comma-separated list of card fields: badges, checkItemStates, closed, dateLastActivity, desc, descData, due, email, idAttachmentCover, idBoard, idChecklists, idLabels, idList, idMembers, idMembersVoted, idShort, labels, manualCoverAttachment, name, pos, shortLink, shortUrl, subscribed, or url. | | `board_fields` | string | No | Specifies the fields for the board to be returned if 'board' is 'true'. Valid values are 'all' or a comma-separated list of board fields: closed, dateLastActivity, dateLastView, desc, descData, idOrganization, invitations, invited, labelNames, memberships, name, pinned, powerUps, prefs, shortLink, shortUrl, starred, subscribed, or url. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get list field value **Slug:** `TRELLO_GET_LISTS_BY_ID_LIST_BY_FIELD` Fetches the value of a single, specified field from a Trello list. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field to retrieve from the list object. Only one field can be retrieved per request. Supported fields: name (string), closed (boolean), idBoard (string), pos (number), subscribed (boolean). | | `idList` | string | Yes | The unique identifier of the Trello list. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get cards in a list **Slug:** `TRELLO_GET_LISTS_CARDS_BY_ID_LIST` Fetches cards from a Trello list by its ID, with options to filter and customize the returned card data. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | string | No | The maximum number of cards to return. Must be a number from 1 to 1000, provided as a string. | | `since` | string | No | Filter cards to include only those created or updated after this date. Provide a date string (e.g., YYYY-MM-DD or an ISO 8601 datetime string) or 'null'. | | `before` | string | No | Filter cards to include only those created or updated before this date. Provide a date string (e.g., YYYY-MM-DD or an ISO 8601 datetime string) or 'null'. | | `fields` | string | No | Fields to include for cards. Defaults to a minimal set: 'id,name,desc,idList,labels,idMembers,due,closed,url'. Use 'all' to return all fields (warning: significantly larger response with extensive nested metadata like badges, limits, nodeId, etc. - 10-20x more data than minimal set). Valid fields include: id, address, badges, checkItemStates, closed, coordinates, creationMethod, dateLastActivity, desc, descData, due, dueComplete, email, idAttachmentCover, idBoard, idChecklists, idLabels, idList, idMembers, idMembersVoted, idShort, labels, limits, manualCoverAttachment, name, nodeId, pos, shortLink, shortUrl, subscribed, url. | | `filter` | string | No | Filter cards by their state. Valid values are 'all', 'closed', 'none', or 'open'. Defaults to 'open'. | | `idList` | string | Yes | The ID of the list from which to retrieve cards. | | `actions` | string | No | Determines what actions are returned. Use 'all' to return all actions, or provide a comma-separated list of specific action types. Valid action types include: addAttachmentToCard, addChecklistToCard, addMemberToBoard, addMemberToCard, addMemberToOrganization, addToOrganizationBoard, commentCard, convertToCardFromCheckItem, copyBoard, copyCard, copyCommentCard, createBoard, createCard, createList, createOrganization, deleteAttachmentFromCard, deleteBoardInvitation, deleteCard, deleteOrganizationInvitation, disablePowerUp, emailCard, enablePowerUp, makeAdminOfBoard, makeNormalMemberOfBoard, makeNormalMemberOfOrganization, makeObserverOfBoard, memberJoinedTrello, moveCardFromBoard, moveCardToBoard, moveListFromBoard, moveListToBoard, removeChecklistFromCard, removeFromOrganizationBoard, removeMemberFromCard, unconfirmedBoardInvitation, unconfirmedOrganizationInvitation, updateBoard, updateCard, updateCard:closed, updateCard:desc, updateCard:idList, updateCard:name, updateCheckItemStateOnCard, updateChecklist, updateList, updateList:closed, updateList:name, updateMember, or updateOrganization. | | `members` | string | No | Specify whether to include members. Accepted string values are 'true' or 'false'. | | `stickers` | string | No | Specify whether to include stickers. Accepted string values are 'true' or 'false'. | | `checklists` | string | No | Specify whether to include checklists. Valid values are 'all' or 'none'. Defaults to 'none'. | | `attachments` | string | No | Specify whether to include attachments. Accepted string values are 'true', 'false', or 'cover' (to retrieve only card cover attachments). | | `member_fields` | string | No | Fields to include for members. Use 'all' or a comma-separated list of specific fields. Valid fields include: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, or username. Defaults to 'avatarHash,fullName,initials,username'. | | `checkItemStates` | string | No | Specify whether to include check item states. Accepted string values are 'true' or 'false'. | | `attachment_fields` | string | No | Fields to include for attachments. Use 'all' or a comma-separated list of specific fields. Valid fields include: bytes, date, edgeColor, idMember, isUpload, mimeType, name, previews, or url. Defaults to 'all'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Member Board Background **Slug:** `TRELLO_GET_MEMBER_BOARD_BACKGROUND` Retrieves a specific custom board background for a Trello member by its ID. Note: Only custom backgrounds (uploaded by the user) can be retrieved; built-in defaults like 'blue' or 'gradient-ocean' are not accessible via this endpoint. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies which fields to include in the response. Use 'all' for all fields, or a comma-separated list of specific field names. Valid field names: 'brightness', 'fullSizeUrl', 'scaled', 'tile', 'bottomColor', 'topColor', 'type'. | | `idMember` | string | Yes | The ID or username of the Trello member. Use 'me' to refer to the authenticated user. | | `idBoardBackground` | string | Yes | The ID of the custom board background to retrieve. This must be a valid 24-character MongoDB-style ID for a custom background uploaded by the member (e.g., '6972322c4864f4a8f73fcaef'). Default/built-in backgrounds (like 'blue', 'orange') cannot be retrieved with this endpoint. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member custom board background **Slug:** `TRELLO_GET_MEMBER_CUSTOM_BG` Retrieves metadata (e.g., brightness, URLs, tiling status) for a specific custom board background of a Trello member, not the image file itself. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Fields to return for the custom board background. Use 'all' or a comma-separated list. Allowed: `brightness`, `fullSizeUrl`, `scaled`, `tile`. | | `idMember` | string | Yes | The ID or username of the Trello member. | | `idBoardBackground` | string | Yes | Unique identifier of the custom board background to retrieve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member custom emoji **Slug:** `TRELLO_GET_MEMBER_CUSTOM_EMOJI` Retrieves a specific custom emoji by its ID for a Trello member, requiring that both the member and emoji exist and are associated. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Determines which fields to include in the response for the custom emoji. Valid values are 'all' or a comma-separated list of field names (e.g., 'name', 'url'). Defaults to 'all'. | | `idMember` | string | Yes | The ID or username of the Trello member. This identifies the owner of the custom emoji. | | `idCustomEmoji` | string | Yes | The ID of the custom emoji to be retrieved. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get field of member's invited organization **Slug:** `TRELLO_GET_MEMBER_INVITED_ORG` Get a specific field of an organization to which the member has a pending invitation; returns data only if such an invitation exists. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific organization field to retrieve. Valid values: name, displayName, desc, url, website. | | `idMember` | string | Yes | The ID or username of the Trello member. Use 'me' to reference the authenticated user. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get organization member cards **Slug:** `TRELLO_GET_MEMBER_ORG_CARDS` Fetches all cards assigned to a specific member of a given Trello organization. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list` | string | No | Indicates whether to include the list object to which the card belongs. Accepts 'true' or 'false'. | | `board` | string | No | Indicates whether to include the board object to which the card belongs. Accepts 'true' or 'false'. | | `idOrg` | string | Yes | The ID of the Trello organization (workspace). Must be a valid 24-character alphanumeric ID. | | `fields` | string | No | Specifies which card fields to include in the response. Accepts 'all' or a comma-separated list of valid card fields: badges, checkItemStates, closed, dateLastActivity, desc, descData, due, email, idAttachmentCover, idBoard, idChecklists, idLabels, idList, idMembers, idMembersVoted, idShort, labels, manualCoverAttachment, name, pos, shortLink, shortUrl, subscribed or url. | | `filter` | string | No | Filters the cards to retrieve. Allowed values are 'all', 'closed', 'none', 'open', or 'visible'. | | `actions` | string | No | Filters actions on the cards. Accepts 'all' or a comma-separated list of action types. Valid types include: addAttachmentToCard, addChecklistToCard, addMemberToBoard, addMemberToCard, addMemberToOrganization, addToOrganizationBoard, commentCard, convertToCardFromCheckItem, copyBoard, copyCard, copyCommentCard, createBoard, createCard, createList, createOrganization, deleteAttachmentFromCard, deleteBoardInvitation, deleteCard, deleteOrganizationInvitation, disablePowerUp, emailCard, enablePowerUp, makeAdminOfBoard, makeNormalMemberOfBoard, makeNormalMemberOfOrganization, makeObserverOfBoard, memberJoinedTrello, moveCardFromBoard, moveCardToBoard, moveListFromBoard, moveListToBoard, removeChecklistFromCard, removeFromOrganizationBoard, removeMemberFromCard, unconfirmedBoardInvitation, unconfirmedOrganizationInvitation, updateBoard, updateCard, updateCard:closed, updateCard:desc, updateCard:idList, updateCard:name, updateCheckItemStateOnCard, updateChecklist, updateList, updateList:closed, updateList:name, updateMember or updateOrganization. | | `members` | string | No | Indicates whether to include member data on the cards. Accepts 'true' or 'false'. | | `idMember` | string | Yes | The ID of the member whose cards are to be retrieved. Must be a valid 24-character alphanumeric member ID (not username or 'me'). | | `checklists` | string | No | Determines whether to include checklists on the cards. Accepts 'all' or 'none'. | | `attachments` | string | No | Determines whether to include attachments. Accepts a boolean string ('true'/'false') or 'cover' to only include card cover attachments. | | `list_fields` | string | No | Specifies which list fields to include if 'list' is 'true'. Accepts 'all' or a comma-separated list of valid fields: closed, idBoard, name, pos or subscribed. | | `board_fields` | string | No | Specifies which board fields to include if 'board' is 'true'. Accepts 'all' or a comma-separated list of valid fields: closed, dateLastActivity, dateLastView, desc, descData, idOrganization, invitations, invited, labelNames, memberships, name, pinned, powerUps, prefs, shortLink, shortUrl, starred, subscribed or url. | | `member_fields` | string | No | Specifies which member fields to include if 'members' is 'true'. Accepts 'all' or a comma-separated list of valid fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url or username. | | `checkItemStates` | string | No | Indicates whether to include check item states on the cards. Accepts 'true' or 'false'. | | `attachment_fields` | string | No | Specifies which attachment fields to include if attachments are retrieved. Accepts 'all' or a comma-separated list of valid fields: bytes, date, edgeColor, idMember, isUpload, mimeType, name, previews or url. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member actions by ID **Slug:** `TRELLO_GET_MEMBERS_ACTIONS_BY_ID_MEMBER` Retrieves a list of actions for a specified Trello member, allowing filtering by type, date, models, and control over output format and fields. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `page` | string | No | The page number for pagination (0-indexed). Note: `page * limit` must result in an offset less than 1000 actions from the start of the list. | | `limit` | string | No | The maximum number of actions to return. Must be a number between 0 and 1000 (inclusive). | | `since` | string | No | Filters actions to include only those that occurred on or after this date. Can be a valid date string (ISO 8601 format recommended), 'null', or 'lastView' (actions since the member last viewed the relevant context). | | `before` | string | No | Filters actions to include only those that occurred on or before this date. Can be a valid date string (ISO 8601 format recommended) or 'null'. | | `fields` | string | No | A comma-separated list of action fields to be returned. Available fields: data, date, idMemberCreator, type. | | `filter` | string | No | A comma-separated list of action types to filter by. Available filters: addAttachmentToCard, addChecklistToCard, addMemberToBoard, addMemberToCard, addMemberToOrganization, addToOrganizationBoard, commentCard, convertToCardFromCheckItem, copyBoard, copyCard, copyCommentCard, createBoard, createCard, createList, createOrganization, deleteAttachmentFromCard, deleteBoardInvitation, deleteCard, deleteOrganizationInvitation, disablePowerUp, emailCard, enablePowerUp, makeAdminOfBoard, makeNormalMemberOfBoard, makeNormalMemberOfOrganization, makeObserverOfBoard, memberJoinedTrello, moveCardFromBoard, moveCardToBoard, moveListFromBoard, moveListToBoard, removeChecklistFromCard, removeFromOrganizationBoard, removeMemberFromCard, unconfirmedBoardInvitation, unconfirmedOrganizationInvitation, updateBoard, updateCard, updateCard:closed, updateCard:desc, updateCard:idList, updateCard:name, updateCheckItemStateOnCard, updateChecklist, updateList, updateList:closed, updateList:name, updateMember, or updateOrganization. | | `format` | string | No | The format of the returned actions. Valid values: 'count' (returns only the count of actions), 'list' (returns actions as a list), 'minimal' (returns minimal action data). | | `member` | string | No | Determines whether to include the member object (details of the member who performed the action) within each action's data. Set to 'true' to include, or 'false' to exclude. | | `display` | string | No | Determines whether to include display-friendly names for the objects referenced in the actions. Set to 'true' to include, or 'false' to exclude. | | `entities` | string | No | Determines whether to include data for the objects (e.g., cards, boards) referenced in the actions. Set to 'true' to include, or 'false' to exclude. | | `idMember` | string | Yes | The ID or username of the Trello member whose actions are to be retrieved. | | `idModels` | string | No | A comma-separated list of model IDs (e.g., card IDs, board IDs) to filter actions by. Only actions related to these models will be returned. | | `memberCreator` | string | No | Determines whether to include the `memberCreator` object (details of the member who created the item/action) within each action's data. Set to 'true' to include, or 'false' to exclude. | | `member_fields` | string | No | A comma-separated list of fields to include for the member object (if `member` is 'true'). Use 'all' for all available fields. Available fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | | `memberCreator_fields` | string | No | A comma-separated list of fields to include for the `memberCreator` object (if `memberCreator` is 'true'). Use 'all' for all available fields. Available fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member board backgrounds **Slug:** `TRELLO_GET_MEMBERS_BOARD_BACKGROUNDS_BY_ID_MEMBER` Fetches the board backgrounds for a specified Trello member. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `filter` | string | No | Filters the types of board backgrounds to return. Allowed values: 'all', 'custom', 'default', 'none', 'premium'. | | `idMember` | string | Yes | The ID or username of the Trello member. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member boards by id **Slug:** `TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER` Retrieves board-level details (not lists/cards) for Trello boards associated with a member ID or username, allowing extensive customization of the returned data. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `lists` | string | No | Filters the lists returned for each board. Valid values: 'all', 'closed', 'none', 'open'. | | `fields` | string | No | Specifies the fields to return for each board. Accepts 'all' or a comma-separated list of field names. Possible field names: 'closed', 'dateLastActivity', 'dateLastView', 'desc', 'descData', 'idOrganization', 'invitations', 'invited', 'labelNames', 'memberships', 'name', 'pinned', 'powerUps', 'prefs', 'shortLink', 'shortUrl', 'starred', 'subscribed', 'url'. | | `filter` | string | No | Filters the boards returned. Valid values are 'all' or a comma-separated list of: 'closed', 'members', 'open', 'organization', 'pinned', 'public', 'starred', 'unpinned'. | | `actions` | string | No | Specifies which actions to return for each board. Accepts 'all' or a comma-separated list of action types. Possible action types: 'addAttachmentToCard', 'addChecklistToCard', 'addMemberToBoard', 'addMemberToCard', 'addMemberToOrganization', 'addToOrganizationBoard', 'commentCard', 'convertToCardFromCheckItem', 'copyBoard', 'copyCard', 'copyCommentCard', 'createBoard', 'createCard', 'createList', 'createOrganization', 'deleteAttachmentFromCard', 'deleteBoardInvitation', 'deleteCard', 'deleteOrganizationInvitation', 'disablePowerUp', 'emailCard', 'enablePowerUp', 'makeAdminOfBoard', 'makeNormalMemberOfBoard', 'makeNormalMemberOfOrganization', 'makeObserverOfBoard', 'memberJoinedTrello', 'moveCardFromBoard', 'moveCardToBoard', 'moveListFromBoard', 'moveListToBoard', 'removeChecklistFromCard', 'removeFromOrganizationBoard', 'removeMemberFromCard', 'unconfirmedBoardInvitation', 'unconfirmedOrganizationInvitation', 'updateBoard', 'updateCard', 'updateCard:closed', 'updateCard:desc', 'updateCard:idList', 'updateCard:name', 'updateCheckItemStateOnCard', 'updateChecklist', 'updateList', 'updateList:closed', 'updateList:name', 'updateMember', 'updateOrganization'. | | `idMember` | string | No | The ID or username of the Trello member. Use 'me' to refer to the authenticated user. Defaults to 'me' if not provided. | | `memberships` | string | No | Filters boards by the member's membership type. Accepts 'all' or a comma-separated list of: 'active', 'admin', 'deactivated', 'me', 'normal'. | | `organization` | string | No | Determines whether to return organization data for boards. Valid values: 'true' or 'false'. | | `action_fields` | string | No | Specifies fields for returned actions if actions are requested. Accepts 'all' or a comma-separated list: 'data', 'date', 'idMemberCreator', 'type'. | | `actions_limit` | string | No | The maximum number of actions to return, from 0 to 1000. | | `actions_since` | string | No | Filters actions to those that occurred after this date, or accepts 'null' or 'lastView'. | | `actions_format` | string | No | The format for returned actions. Valid values: 'count', 'list', or 'minimal'. | | `actions_entities` | string | No | Determines whether to return entity data for actions. Valid values: 'true' or 'false'. | | `organization_fields` | string | No | Specifies the fields to return for the organization if 'organization' is 'true'. Accepts 'all' or a comma-separated list of field names. Possible field names: 'billableMemberCount', 'desc', 'descData', 'displayName', 'idBoards', 'invitations', 'invited', 'logoHash', 'memberships', 'name', 'powerUps', 'prefs', 'premiumFeatures', 'products', 'url', 'website'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member boards with filter **Slug:** `TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER_BY_FILTER` Retrieves a list of boards for a specific Trello member, applying a filter such as 'open', 'starred', or 'all'. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Comma-separated list of board fields to include in the response. Use 'all' to include all fields. Limiting fields reduces response size significantly. | | `filter` | string | No | The filter to apply when retrieving boards. Determines which subset of boards is returned. | | `idMember` | string | Yes | The ID or username of the Trello member whose boards are to be retrieved. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member's invited boards **Slug:** `TRELLO_GET_MEMBERS_BOARDS_INVITED_BY_ID_MEMBER` Retrieves Trello boards to which a specific member has been invited but has not yet joined. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Board fields to return: 'all' or a comma-separated list (e.g., name,url). Valid fields: closed, dateLastActivity, dateLastView, desc, descData, idOrganization, invitations, invited, labelNames, memberships, name, pinned, powerUps, prefs, shortLink, shortUrl, starred, subscribed, url. | | `idMember` | string | No | The ID or username of the Trello member whose pending board invitations are to be retrieved. Use 'me' to refer to the authenticated user. Defaults to 'me' if not provided. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member's invited board field **Slug:** `TRELLO_GET_MEMBERS_BOARDS_INVITED_BY_ID_MEMBER_BY_FIELD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field of the invited boards to retrieve. This refers to a property of the board. | | `idMember` | string | Yes | The ID or username of the Trello member whose invited board field is to be retrieved. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member board stars **Slug:** `TRELLO_GET_MEMBERS_BOARD_STARS_BY_ID_MEMBER` Fetches only the boards a specific Trello member has starred, identified by their ID or username. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idMember` | string | Yes | The ID or username of the Trello member. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member board star **Slug:** `TRELLO_GET_MEMBERS_BOARD_STARS_BY_ID_MEMBER_BY_ID_BOARD_STAR` Retrieves detailed information about a specific board star (a Trello board marked as a favorite) for a given Trello member. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idMember` | string | Yes | The ID or username of the Trello member. This specifies whose board star information is being retrieved. | | `idBoardStar` | string | Yes | The unique identifier of the board star. Each starred board has a unique ID, which is used to fetch its specific details. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member by ID **Slug:** `TRELLO_GET_MEMBERS_BY_ID_MEMBER` Fetches comprehensive information about a Trello member, specified by ID or username, including profile, activities, boards, cards, notifications, and organization affiliations, with customizable detail levels via filters and field parameters. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cards` | string | No | Filters cards. Valid values: 'all', 'closed', 'none', 'open', 'visible'. | | `boards` | string | No | Filters boards. Valid values: 'all' or a comma-separated list (e.g., 'open,starred'). | | `fields` | string | No | Member fields to return. Valid values: 'all' or a comma-separated list (e.g., 'fullName,username,email'). | | `tokens` | string | No | Filters API tokens for the member. Valid values: 'all', 'none'. | | `actions` | string | No | Filters actions by type. Valid values: 'all' or a comma-separated list of action types (e.g., addAttachmentToCard, commentCard, createBoard). | | `idMember` | string | Yes | The ID or username of the Trello member. | | `boardStars` | string | No | Include information about the member's starred boards. Valid values: 'true', 'false'. | | `board_lists` | string | No | Filters lists on boards. Valid values: 'all', 'closed', 'none', 'open'. | | `card_fields` | string | No | Fields to return for each card. Valid values: 'all' or a comma-separated list (e.g., 'name,desc'). | | `customEmoji` | string | No | Filters custom emoji. Valid values: 'all', 'none'. | | `action_since` | string | No | Retrieve actions created after this date/time (ISO 8601 or 'lastView'), or 'null' for no restriction. | | `board_fields` | string | No | Fields to return for each board. Valid values: 'all' or a comma-separated list (e.g., 'name,idOrganization'). | | `card_members` | string | No | Include member objects for each card. Valid values: 'true', 'false'. | | `paid_account` | string | No | Include paid account information for the member. Valid values: 'true', 'false'. | | `action_before` | string | No | Retrieve actions created before this date/time (ISO 8601), or 'null' for no restriction. | | `action_fields` | string | No | Fields to return for each action. Valid values: 'all' or a comma-separated list (e.g., 'data,date'). | | `actions_limit` | string | No | Maximum number of actions to return (0-1000). | | `board_actions` | string | No | Filters board actions by type. Valid values: 'all' or a comma-separated list of action types (e.g., createCard, updateBoard). | | `boardsInvited` | string | No | Filters boards the member has been invited to. Valid values: 'all' or a comma-separated list (e.g., 'open,starred'). | | `card_stickers` | string | No | Include sticker information for cards. Valid values: 'true', 'false'. | | `notifications` | string | No | Filters notifications by type. Valid values: 'all' or a comma-separated list of notification types (e.g., commentCard, addedToBoard). | | `organizations` | string | No | Filters organizations the member belongs to. Valid values: 'all', 'members', 'none', 'public'. | | `savedSearches` | string | No | Include the member's saved searches. Valid values: 'true', 'false'. | | `customStickers` | string | No | Filters custom stickers. Valid values: 'all', 'none'. | | `actions_display` | string | No | Include display information for actions. Valid values: 'true', 'false'. | | `actions_entities` | string | No | Include related entities in actions. Valid values: 'true', 'false'. | | `boardBackgrounds` | string | No | Filters board backgrounds. Valid values: 'all', 'custom', 'default', 'none', 'premium'. | | `card_attachments` | string | No | Include card attachments. Valid values: 'true', 'false', 'cover'. | | `board_memberships` | string | No | Filters board memberships. Valid values: 'all' or a comma-separated list (e.g., 'active,admin'). | | `board_organization` | string | No | Include the organization for each board. Valid values: 'true', 'false'. | | `card_member_fields` | string | No | Fields to return for card members. Valid values: 'all' or a comma-separated list (e.g., 'fullName,username'). | | `notification_since` | string | No | Retrieve notifications created after this notification ID, or 'null' for no restriction. | | `board_action_fields` | string | No | Fields to return for each board action. Valid values: 'all' or a comma-separated list (e.g., 'data,date'). | | `board_actions_limit` | string | No | Maximum number of board actions to return (0-1000). | | `board_actions_since` | string | No | Retrieve board actions created after this date/time (ISO 8601 or 'lastView'), or 'null' for no restriction. | | `notification_before` | string | No | Retrieve notifications created before this notification ID, or 'null' for no restriction. | | `notification_fields` | string | No | Fields to return for notifications. Valid values: 'all' or a comma-separated list (e.g., 'data,date,unread'). | | `notifications_limit` | string | No | Maximum number of notifications to return (1-1000). | | `organization_fields` | string | No | Fields to return for organizations. Valid values: 'all' or a comma-separated list (e.g., 'name,displayName'). | | `board_actions_format` | string | No | Format for board actions. Valid values: 'count', 'list', 'minimal'. | | `boardsInvited_fields` | string | No | Fields to return for boards the member has been invited to. Valid values: 'all' or a comma-separated list (e.g., 'name,idOrganization'). | | `organizationsInvited` | string | No | Filters organizations the member has been invited to. Valid values: 'all', 'members', 'none', 'public'. | | `board_actions_display` | string | No | Include display information for board actions. Valid values: 'true', 'false'. | | `notifications_display` | string | No | Include display information for notifications. Valid values: 'true', 'false'. | | `board_actions_entities` | string | No | Include related entities in board actions. Valid values: 'true', 'false'. | | `card_attachment_fields` | string | No | Fields to return for card attachments. Valid values: 'all' or a comma-separated list (e.g., 'url,name'). | | `customBoardBackgrounds` | string | No | Filters custom board backgrounds. Valid values: 'all', 'none'. | | `notifications_entities` | string | No | Include related entities in notifications. Valid values: 'true', 'false'. | | `board_organization_fields` | string | No | Fields to return for the board's organization. Valid values: 'all' or a comma-separated list (e.g., 'name,displayName'). | | `organization_paid_account` | string | No | Include paid account information for organizations. Valid values: 'true', 'false'. | | `notification_memberCreator` | string | No | Include the member creator for notifications. Valid values: 'true', 'false'. | | `organizationsInvited_fields` | string | No | Fields to return for organizations the member has been invited to. Valid values: 'all' or a comma-separated list (e.g., 'name,displayName'). | | `notification_memberCreator_fields` | string | No | Fields for the notification member creator. Valid values: 'all' or a comma-separated list (e.g., 'fullName,username'). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member field by ID **Slug:** `TRELLO_GET_MEMBERS_BY_ID_MEMBER_BY_FIELD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field of the member to retrieve. Common fields include: fullName, username, bio, email, avatarUrl, initials, memberType, idBoards, idOrganizations, url, status. | | `idMember` | string | Yes | The ID or username of the Trello member. Use 'me' to refer to the authenticated user. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get cards by member ID **Slug:** `TRELLO_GET_MEMBERS_CARDS_BY_ID_MEMBER` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | string | No | Max cards to return (1-1000). Trello's default applies if omitted. | | `since` | string | No | Return cards updated after this ISO 8601 date. 'null' or omit for no lower limit. | | `before` | string | No | Return cards updated before this ISO 8601 date. 'null' or omit for no upper limit. | | `fields` | string | No | Card fields to return. 'all' or comma-separated (e.g., `name`, `due`, `idBoard`, `labels`). | | `filter` | string | No | Card filter: 'all', 'closed', 'none', 'open', or 'visible'. 'visible' means cards on open boards member can see. | | `actions` | string | No | Filters actions on cards. 'all' or comma-separated Trello action types (e.g., `commentCard`, `createCard`). | | `members` | string | No | Include member details on cards: 'true' or 'false'. | | `idMember` | string | Yes | The ID or username of the Trello member. Use 'me' for the authenticated user. | | `stickers` | string | No | Include stickers: 'true' or 'false'. | | `checklists` | string | No | Include checklists: 'all' or 'none'. | | `attachments` | string | No | Include attachments: 'true' (all), 'false' (none), or 'cover' (card cover only). | | `member_fields` | string | No | Member fields if 'members' is true. 'all' or comma-separated (e.g., `fullName`, `username`, `initials`). | | `checkItemStates` | string | No | Include check item states: 'true' or 'false'. | | `attachment_fields` | string | No | Attachment fields if including attachments. 'all' or comma-separated (e.g., `name`, `url`, `date`). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Retrieve member custom board backgrounds **Slug:** `TRELLO_GET_MEMBERS_CUSTOM_BOARD_BACKGROUNDS_BY_ID_MEMBER` Retrieves custom board backgrounds for a Trello member, who must exist, using their ID or username. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `filter` | string | No | Filter for custom board backgrounds. Valid values: 'all' or 'none'. | | `idMember` | string | Yes | The ID or username of the Trello member. Use 'me' for the authenticated user. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member custom emoji **Slug:** `TRELLO_GET_MEMBERS_CUSTOM_EMOJI_BY_ID_MEMBER` Retrieves all custom (user-specific, non-standard) emojis that a specified Trello member has created or can access. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `filter` | string | No | Filter for which custom emojis to return. Use 'all' to include all custom emojis, or 'none' to exclude them. | | `idMember` | string | Yes | The ID or username of the Trello member for whom to retrieve custom emojis. Use 'me' for the authenticated user. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member custom stickers **Slug:** `TRELLO_GET_MEMBERS_CUSTOM_STICKERS_BY_ID_MEMBER` Retrieves a member's custom stickers, which are unique personalized stickers created by them, distinct from standard Trello stickers. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `filter` | string | No | Specifies which custom stickers to return: 'all' for all stickers of the member, or 'none' for no stickers. | | `idMember` | string | Yes | ID (24-character hex) or username of the Trello member. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member custom sticker **Slug:** `TRELLO_GET_MEMBERS_CUSTOM_STICKERS_BY_ID_MEMBER_BY_ID_STICKE` Get member custom sticker #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies which fields to include in the response. Use 'all' (default) to return all available fields, or provide a comma-separated list of specific fields: 'url' (sticker image URL), 'scaled' (array of scaled image versions). | | `idMember` | string | Yes | The unique identifier (TrelloID) or username of the Trello member. Use 'me' to refer to the authenticated user. | | `idCustomSticker` | string | Yes | The unique identifier (TrelloID) of the custom sticker to retrieve. This ID is obtained from the list of member's custom stickers. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member deltas by ID **Slug:** `TRELLO_GET_MEMBERS_DELTAS_BY_ID_MEMBER` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `tags` | string | Yes | A tag to filter the deltas by type. Common values include 'boards' for board changes, 'cards' for card changes, or 'all' for all types of changes. | | `idMember` | string | Yes | The unique identifier (ID) or username of the Trello member. You can use 'me' to refer to the currently authenticated user. | | `ixLastUpdate` | string | Yes | The sequence number of the last update received. Use '-1' to retrieve all deltas from the beginning, or a positive integer to get changes that occurred after this update sequence number. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get authenticated member **Slug:** `TRELLO_GET_MEMBERS_ME` Tool to retrieve information about the currently authenticated Trello member. Use when you need profile details, settings, or member metadata. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cards` | string | No | Optional parameter to include cards. Accepts 'all', 'none', or card filter values like 'open', 'closed', 'visible'. | | `boards` | string | No | Optional parameter to include boards. Accepts 'all' or a comma-separated list of board filters. | | `fields` | string | No | Comma-separated list of member fields to return. Use 'all' for all fields. Valid field names: id, activityBlocked, avatarHash, avatarUrl, avatarSource, bio, bioData, confirmed, fullName, idEnterprise, idEnterprisesDeactivated, idMemberReferrer, idPremOrgsAdmin, initials, memberType, nonPublic, nonPublicAvailable, products, url, username, status, aaId, aaEmail, email, gravatarHash, idBoards, idBoardsPinned, idOrganizations, loginTypes, oneTimeMessagesDismissed, prefs, premiumFeatures, trophies, uploadedAvatarHash. | | `actions` | string | No | Optional parameter to include actions. Accepts 'all' or a comma-separated list of action types. | | `boardStars` | string | No | Optional parameter to include board stars. Valid values: 'all' or 'none'. | | `customEmoji` | string | No | Optional parameter to include custom emoji. Valid values: 'all' or 'none'. | | `boardsInvited` | string | No | Optional parameter to include boards the member is invited to. Valid values: 'all' or 'none'. | | `customStickers` | string | No | Optional parameter to include custom stickers. Valid values: 'all' or 'none'. | | `boardBackgrounds` | string | No | Optional parameter to include board backgrounds. Valid values: 'all', 'none', or 'default'. | | `customBoardBackgrounds` | string | No | Optional parameter to include custom board backgrounds. Valid values: 'all' or 'none'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get authenticated user's boards (Deprecated) **Slug:** `TRELLO_GET_MEMBERS_ME_BOARDS` DEPRECATED: Use TRELLO_MEMBER_GET_BOARDS_BY_ID_MEMBER instead. Tool to retrieve all boards for the authenticated user (name, URL, and other metadata). Use when you need to list boards or get board IDs for further operations. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Comma-separated list of board fields to return. Common fields: name, url, id, closed, desc, idOrganization, pinned, starred, shortUrl. Use 'all' to return all fields. | | `filter` | string ("all" | "closed" | "members" | "open" | "organization" | "public" | "starred" | "unpinned") | No | Filter which boards to return. Options: all (all boards), closed (archived boards), members (boards where user is a member), open (active boards), organization (workspace boards), public (public boards), starred (starred boards), unpinned (unpinned boards). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member notifications by id **Slug:** `TRELLO_GET_MEMBERS_NOTIFICATIONS_BY_ID_MEMBER` Retrieves notifications for a Trello member, specified by their ID or username, with options for filtering and pagination. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `page` | string | No | Page number for pagination (0-100). | | `limit` | string | No | Maximum notifications to return (1-1000). | | `since` | string | No | Notification ID for pagination; returns notifications created after this ID. | | `before` | string | No | Notification ID for pagination; returns notifications created before this ID. | | `fields` | string | No | Comma-separated list of notification fields to return, or 'all'. Available fields: data, date, idMemberCreator, type, unread. | | `filter` | string | No | Comma-separated list of notification types to filter by, or 'all'. Refer to Trello API documentation for the complete list of available types. | | `display` | string | No | Include display-related information (e.g., translation keys). Set to 'true' for inclusion. | | `entities` | string | No | Include entity data (e.g., card, board names). Set to 'true' for inclusion. | | `idMember` | string | Yes | The ID or username of the member. | | `read_filter` | string | No | Filter by read status: 'all', 'read', or 'unread'. | | `memberCreator` | string | No | Include details of the notification's creator. Set 'true' to include. | | `memberCreator_fields` | string | No | Comma-separated list of fields for the member creator, or 'all'; applies if 'memberCreator' is 'true'. Available fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get a specified member's organizations **Slug:** `TRELLO_GET_MEMBERS_ORGANIZATIONS_BY_ID_MEMBER` Fetches organizations a specific Trello member belongs to; the `idMember` must be an ID or username of an existing Trello member. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies which fields to include in the response. Use 'all' for all available fields, or provide a comma-separated list of specific fields. Available fields: billableMemberCount, desc, descData, displayName, idBoards, invitations, invited, logoHash, memberships, name, powerUps, prefs, premiumFeatures, products, url, website. | | `filter` | string | No | Filters the types of organizations returned. Use 'all' for all organizations, 'members' for organizations where the member has a role, 'none' for organizations with no specific filter, or 'public' for public organizations. | | `idMember` | string | Yes | The ID or username of the Trello member. | | `paid_account` | string | No | Filters organizations based on whether they have a paid Trello account. Provide 'true' to list only organizations with a paid account, or 'false' for those without. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Retrieve member s invited organizations **Slug:** `TRELLO_GET_MEMBERS_ORGANIZATIONS_INVITED_BY_ID_MEMBER` Retrieves organizations a Trello member has been invited to but has not yet accepted or declined. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Fields to return for invited organizations. Accepts 'all' or a comma-separated list (e.g., 'name,url', 'displayName,descData,idBoards'). Available: billableMemberCount, desc, descData, displayName, idBoards, invitations, invited, logoHash, memberships, name, powerUps, prefs, premiumFeatures, products, url, website. | | `idMember` | string | Yes | The ID or username of the Trello member. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member saved searches **Slug:** `TRELLO_GET_MEMBERS_SAVED_SEARCHES_BY_ID_MEMBER` Retrieves all saved search queries for a Trello member; this action only retrieves saved searches and does not execute them. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idMember` | string | Yes | The ID or username of the Trello member. The ID is a 24-character hexadecimal string. Usernames can also be used. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Member Saved Search **Slug:** `TRELLO_GET_MEMBERS_SAVED_SEARCHES_BY_ID_MEMBER_BY_ID_SAVED_S` Get Member Saved Search #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idMember` | string | Yes | The ID or username of the Trello member whose saved search is to be retrieved. Use 'me' to refer to the current authenticated user. | | `idSavedSearch` | string | Yes | The unique identifier of the saved search to retrieve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Retrieve member tokens **Slug:** `TRELLO_GET_MEMBERS_TOKENS_BY_ID_MEMBER` Retrieves API token metadata for a Trello member. Returns information about all API tokens associated with the specified member, including token ID, creation date, expiration date, permissions, and the application that created each token. For security reasons, the actual token values are not included in the response. Note: You can only retrieve tokens for your own account (use 'me' or your own member ID). Attempting to access another member's tokens will fail. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `filter` | string | No | Filters the list of tokens. Use 'all' to retrieve all tokens or 'none' to retrieve no tokens. | | `idMember` | string | Yes | The ID or username of the Trello member. Use 'me' to reference the currently authenticated member. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get notification board by ID **Slug:** `TRELLO_GET_NOTIFICATIONS_BOARD_BY_ID_NOTIFICATION` Gets the Trello board associated with a given notification ID, returning only board data and allowing selection of specific board fields. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies the board fields to return. Use 'all' for all fields, or provide a comma-separated list of specific fields. Valid fields include: closed, dateLastActivity, dateLastView, desc, descData, idOrganization, invitations, invited, labelNames, memberships, name, pinned, powerUps, prefs, shortLink, shortUrl, starred, subscribed, or url. | | `idNotification` | string | Yes | The unique identifier of the Trello notification for which to retrieve the associated board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get notification's board field **Slug:** `TRELLO_GET_NOTIFICATIONS_BOARD_BY_ID_NOTIFICATION_BY_FIELD` Retrieves a specific field from the board associated with a Trello notification. This endpoint is useful when you only need a single piece of information about the board (like its name or URL) without fetching all board data. The notification must belong to the authenticated user and must be associated with a board (e.g., board invitations, card comments, or mentions on board-related items). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific board field to retrieve. Valid fields include: name (board name), desc (description), url (full URL), shortUrl (shortened URL), idOrganization (workspace ID), closed (archived status), dateLastActivity, dateLastView, labelNames, memberships, pinned, prefs, shortLink, starred, subscribed. | | `idNotification` | string | Yes | The unique 24-character alphanumeric identifier (TrelloID) of the notification. Notifications are generated when other users take actions that affect you (e.g., mentions, invitations, card assignments). Use GET /members/me/notifications to retrieve your notification IDs. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get notification by ID **Slug:** `TRELLO_GET_NOTIFICATIONS_BY_ID_NOTIFICATION` Retrieves a specific Trello notification by its ID, optionally including related entities and specific fields for the notification and its related entities. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `card` | string | No | Whether to include the associated card. Accepts 'true' or 'false'. | | `list` | string | No | Whether to include the associated list. Accepts 'true' or 'false'. | | `board` | string | No | Whether to include the associated board. Accepts 'true' or 'false'. | | `fields` | string | No | Fields for the notification: 'all' or a comma-separated list (e.g., data,date,type). Available: data, date, idMemberCreator, type, unread. Default: 'all'. | | `member` | string | No | Whether to include the associated member (distinct from memberCreator). Accepts 'true' or 'false'. | | `display` | string | No | Whether to include the notification display status. Accepts 'true' or 'false'. | | `entities` | string | No | Whether to include associated entities (like cards, boards, members). Accepts 'true' or 'false'. | | `card_fields` | string | No | Fields for the card: 'all' or a comma-separated list (e.g., name,due). Available: badges, checkItemStates, closed, dateLastActivity, desc, descData, due, email, idAttachmentCover, idBoard, idChecklists, idLabels, idList, idMembers, idMembersVoted, idShort, labels, manualCoverAttachment, name, pos, shortLink, shortUrl, subscribed, url. Default: 'name'. | | `board_fields` | string | No | Fields for the board: 'all' or a comma-separated list (e.g., name,url). Available: closed, dateLastActivity, dateLastView, desc, descData, idOrganization, invitations, invited, labelNames, memberships, name, pinned, powerUps, prefs, shortLink, shortUrl, starred, subscribed, url. Default: 'name'. | | `organization` | string | No | Whether to include the associated organization. Accepts 'true' or 'false'. | | `memberCreator` | string | No | Whether to include the member who created the notification. Accepts 'true' or 'false'. | | `member_fields` | string | No | Fields for the associated member: 'all' or a comma-separated list (e.g., fullName,initials). Available: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. Default: 'avatarHash,fullName,initials,username'. | | `idNotification` | string | Yes | The unique identifier of the notification to retrieve. | | `organization_fields` | string | No | Fields for the organization: 'all' or a comma-separated list (e.g., displayName,url). Available: billableMemberCount, desc, descData, displayName, idBoards, invitations, invited, logoHash, memberships, name, powerUps, prefs, premiumFeatures, products, url, website. Default: 'displayName'. | | `memberCreator_fields` | string | No | Fields for the member creator: 'all' or a comma-separated list (e.g., fullName,username). Available: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. Default: 'avatarHash,fullName,initials,username'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get a notification field **Slug:** `TRELLO_GET_NOTIFICATIONS_BY_ID_NOTIFICATION_BY_FIELD` Retrieves a specific field from a Trello notification. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field to retrieve from the notification object. Common fields include 'type', 'date', 'data', 'unread', 'idAction', 'idBoard', 'idCard', 'idList', 'idMember', 'idOrganization'. | | `idNotification` | string | Yes | The unique identifier of the notification. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get notification's card **Slug:** `TRELLO_GET_NOTIFICATIONS_CARD_BY_ID_NOTIFICATION` Retrieves the card associated with a Trello notification. Returns card details for card-related notifications (e.g., comments on cards, card assignments, due date reminders). The notification must exist and be linked to a card; notifications without card context (e.g., board-level notifications) will return an error. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Comma-separated list of specific card field names to return, or 'all' for all fields. Available fields: id, address, badges, checkItemStates, closed, coordinates, creationMethod, dueComplete, dateLastActivity, desc, descData, due, dueReminder, idBoard, idChecklists, idLabels, idList, idMembers, idMembersVoted, idShort, idAttachmentCover, labels, limits, locationName, manualCoverAttachment, name, pos, shortLink, shortUrl, subscribed, url, cover, isTemplate. | | `idNotification` | string | Yes | The unique identifier of the Trello notification. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get notification card field **Slug:** `TRELLO_GET_NOTIFICATIONS_CARD_BY_ID_NOTIFICATION_BY_FIELD` Retrieves a specific field of a Trello card, using the ID of a notification that is directly associated with that card. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field of the card to retrieve. Valid card fields: 'badges', 'checkItemStates', 'closed', 'dateLastActivity', 'desc', 'descData', 'due', 'dueComplete', 'email', 'idAttachmentCover', 'idBoard', 'idChecklists', 'idLabels', 'idList', 'idMembers', 'idMembersVoted', 'idShort', 'labels', 'manualCoverAttachment', 'name', 'pos', 'shortLink', 'shortUrl', 'start', 'subscribed', 'url'. | | `idNotification` | string | Yes | The unique identifier (24-character hex string) of the Trello notification. The notification must be associated with a card. Obtain notification IDs from the GET /members/{id}/notifications endpoint. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get notification display by id **Slug:** `TRELLO_GET_NOTIFICATIONS_DISPLAY_BY_ID_NOTIFICATION` Retrieves the information needed to display an existing Trello notification, identified by its ID, without altering the notification or fetching its complete metadata. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idNotification` | string | Yes | The unique identifier (24-character hex string) of the Trello notification. Notification IDs can be obtained from the member's notifications endpoint (GET /members/{id}/notifications). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Notification Entities **Slug:** `TRELLO_GET_NOTIFICATIONS_ENTITIES_BY_ID_NOTIFICATION` Retrieves the entities (members, cards, boards, lists, etc.) associated with a specific Trello notification. Returns an ordered list of entity objects that together describe what happened in the notification. This is useful for building human-readable notification descriptions and activity feeds. For example, a 'mentionedOnCard' notification returns entities like: [member, "mentioned you on", card] which can be combined to display: "John mentioned you on 'My Card'" Note: Requires a valid notification ID that belongs to the authenticated user. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idNotification` | string | Yes | The unique identifier of the Trello notification. You can get notification IDs from the GET /members/{id}/notifications endpoint. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Retrieve notification list by id **Slug:** `TRELLO_GET_NOTIFICATIONS_LIST_BY_ID_NOTIFICATION` Retrieves the Trello list associated with a specific notification ID, for notifications linked to a list (e.g., card creation or movement notifications). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Determines which fields to include in the response. Specify 'all' or a comma-separated list of valid field names. Valid fields are: 'closed', 'idBoard', 'name', 'pos', or 'subscribed'. | | `idNotification` | string | Yes | The ID of the Trello notification for which to retrieve the associated list. Only notifications related to list activity (e.g., card created, card moved) will have a list. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get notification list field **Slug:** `TRELLO_GET_NOTIFICATIONS_LIST_BY_ID_NOTIFICATION_BY_FIELD` Efficiently retrieves a single specified field from a Trello list linked to a notification, avoiding fetching the entire list. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The field to retrieve from the list associated with the notification. Valid values include 'id', 'name', 'closed', 'pos', 'softLimit', 'idBoard', 'subscribed'. | | `idNotification` | string | Yes | The ID of the notification. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get notification member by id **Slug:** `TRELLO_GET_NOTIFICATIONS_MEMBER_BY_ID_NOTIFICATION` Fetches details of the member (not the notification content itself) associated with a specific Trello notification ID. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies the member fields to return. Use 'all' for all available fields, or provide a comma-separated list of specific fields. Valid fields include: avatarHash, avatarSource, bio, bioData, confirmed, email, fullName, gravatarHash, idBoards, idBoardsPinned, idOrganizations, idPremOrgsAdmin, initials, loginTypes, memberType, oneTimeMessagesDismissed, prefs, premiumFeatures, products, status, trophies, uploadedAvatarHash, url, username. | | `idNotification` | string | Yes | The ID of the Trello notification. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Retrieve notification member field **Slug:** `TRELLO_GET_NOTIFICATIONS_MEMBER_BY_ID_NOTIFICATION_BY_FIELD` Retrieves a specific field value of the Trello member associated with a notification. Use this to get individual member properties (like fullName, username, email, etc.) for the member who is the subject of a notification. This is useful when you only need a single piece of member information rather than the full member object. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific member field to retrieve. Valid fields include: avatarHash, avatarSource, bio, bioData, confirmed, email, fullName, gravatarHash, idBoards, idBoardsPinned, idOrganizations, idPremOrgsAdmin, initials, loginTypes, memberType, oneTimeMessagesDismissed, prefs, premiumFeatures, products, status, trophies, uploadedAvatarHash, url, username. | | `idNotification` | string | Yes | The unique identifier (24-character hex string) of the Trello notification whose associated member's field you want to retrieve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get member creator of a notification **Slug:** `TRELLO_GET_NOTIFICATIONS_MEMBER_CREATOR_BY_ID_NOTIFICATION` Fetches the creator (member) of a Trello notification, identified by `idNotification`, returning only creator details and respecting Trello privacy settings and user permissions. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | A comma-separated list of member fields to retrieve, or 'all' for all available fields. Valid fields include: avatarHash, avatarSource, bio, bioData, confirmed, email, fullName, gravatarHash, idBoards, idBoardsPinned, idOrganizations, idPremOrgsAdmin, initials, loginTypes, memberType, oneTimeMessagesDismissed, prefs, premiumFeatures, products, status, trophies, uploadedAvatarHash, url, username. | | `idNotification` | string | Yes | The unique identifier of the Trello notification for which to retrieve the creator's details. This is a 24-character hexadecimal string. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get notification creator field **Slug:** `TRELLO_GET_NOTIFICATIONS_MEMBER_CREATOR_BY_ID_NOTIFICATION_B` Get notification creator field #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field to retrieve from the notification creator's member profile. Valid fields include: avatarHash, avatarSource, bio, bioData, confirmed, fullName, gravatarHash, id, idBoards, idOrganizations, idPremOrgsAdmin, initials, loginTypes, memberType, oneTimeMessagesDismissed, prefs, premiumFeatures, products, status, trophies, uploadedAvatarHash, url, username. | | `idNotification` | string | Yes | The unique identifier (TrelloID) of the notification for which to retrieve the creator's field. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get notification organization **Slug:** `TRELLO_GET_NOTIFICATIONS_ORGANIZATION_BY_ID_NOTIFICATION` Retrieves the Trello organization linked to a specific notification ID; returns organization details only, not the notification itself. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Organization fields to return. Accepts 'all' or a comma-separated list of specific fields (e.g., 'displayName,url'). Allowed fields: billableMemberCount, desc, descData, displayName, idBoards, invitations, invited, logoHash, memberships, name, powerUps, prefs, premiumFeatures, products, url, website. | | `idNotification` | string | Yes | The unique identifier of the notification for which organization details are being requested. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get notification organization field **Slug:** `TRELLO_GET_NOTIFICATIONS_ORGANIZATION_BY_ID_NOTIFICATION_BY_` Get notification organization field #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific organization field to retrieve. Valid fields include: name, displayName, desc, url, website, prefs, memberships, idBoards, billableMemberCount, logoHash, premiumFeatures, products, powerUps, invited, invitations. | | `idNotification` | string | Yes | The unique identifier (ID) of the Trello notification. Must be a 24-character hexadecimal string. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get organization actions by ID **Slug:** `TRELLO_GET_ORGANIZATIONS_ACTIONS_BY_ID_ORG` 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 ID/name, and `page` * `limit` must be < 1000. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `page` | string | No | Page number of results to retrieve (0-indexed). | | `idOrg` | string | Yes | The ID or name of the Trello organization. | | `limit` | string | No | Maximum number of actions to return (0-1000). | | `since` | string | No | Starting point for actions. Can be a specific date (ISO 8601 format or Unix timestamp in milliseconds), 'lastView', or null (actions from the beginning). | | `before` | string | No | Ending point for actions. Can be a specific date (ISO 8601 format or Unix timestamp in milliseconds) or null (actions up to the most recent). | | `fields` | string | No | Specifies the fields to be returned for each action. Use 'all' or a comma-separated list of specific field names. Allowed fields: `data`, `date`, `idMemberCreator`, `type`. | | `filter` | string | No | Filters actions by type. Use 'all' or a comma-separated list of specific action types (e.g., `addAttachmentToCard`, `commentCard`). For a full list of allowed types, refer to the Trello API documentation. | | `format` | string | No | The format of the returned actions. Allowed values: 'count', 'list', or 'minimal'. | | `member` | string | No | Indicates whether to return information for the member who performed the action. | | `display` | string | No | Indicates whether to return display-friendly information for an action (e.g., human-readable strings). | | `entities` | string | No | Indicates whether to return information about entities (e.g., card, board, list) associated with an action. | | `idModels` | string | No | A comma-separated list of Trello model IDs (e.g., card IDs, board IDs, list IDs) to filter actions by. | | `memberCreator` | string | No | Indicates whether to return information for the action creator (usually the same as the member). | | `member_fields` | string | No | Fields for the 'member' object if 'member' is true. Use 'all' or a comma-separated list from: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | | `memberCreator_fields` | string | No | Fields for the 'memberCreator' object if 'memberCreator' is true. Use 'all' or a comma-separated list from: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get organization boards **Slug:** `TRELLO_GET_ORGANIZATIONS_BOARDS_BY_ID_ORG` Fetches boards for a Trello organization, specified by its ID or name, with options to filter and customize returned data. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or name of the organization to retrieve boards from. | | `lists` | string | No | Lists per board. Use 'all', 'closed', 'none', or 'open'. | | `fields` | string | No | Fields for boards. Use 'all' or a comma-separated list: 'closed', 'dateLastActivity', 'dateLastView', 'desc', 'descData', 'idOrganization', 'invitations', 'invited', 'labelNames', 'memberships', 'name', 'pinned', 'powerUps', 'prefs', 'shortLink', 'shortUrl', 'starred', 'subscribed', 'url'. | | `filter` | string | No | Filters boards. Use 'all' or a comma-separated list: 'closed', 'members', 'open', 'organization', 'pinned', 'public', 'starred', 'unpinned'. | | `actions` | string | No | Actions for boards. Use 'all' or a comma-separated list: 'addAttachmentToCard', 'addChecklistToCard', 'addMemberToBoard', 'addMemberToCard', 'addMemberToOrganization', 'addToOrganizationBoard', 'commentCard', 'convertToCardFromCheckItem', 'copyBoard', 'copyCard', 'copyCommentCard', 'createBoard', 'createCard', 'createList', 'createOrganization', 'deleteAttachmentFromCard', 'deleteBoardInvitation', 'deleteCard', 'deleteOrganizationInvitation', 'disablePowerUp', 'emailCard', 'enablePowerUp', 'makeAdminOfBoard', 'makeNormalMemberOfBoard', 'makeNormalMemberOfOrganization', 'makeObserverOfBoard', 'memberJoinedTrello', 'moveCardFromBoard', 'moveCardToBoard', 'moveListFromBoard', 'moveListToBoard', 'removeChecklistFromCard', 'removeFromOrganizationBoard', 'removeMemberFromCard', 'unconfirmedBoardInvitation', 'unconfirmedOrganizationInvitation', 'updateBoard', 'updateCard', 'updateCard:closed', 'updateCard:desc', 'updateCard:idList', 'updateCard:name', 'updateCheckItemStateOnCard', 'updateChecklist', 'updateList', 'updateList:closed', 'updateList:name', 'updateMember', 'updateOrganization'. | | `memberships` | string | No | Board memberships. Use 'all', 'none', or a comma-separated list: 'active', 'admin', 'deactivated', 'me', 'normal'. | | `organization` | string | No | Include organization object with boards. 'true' or 'false'. | | `action_fields` | string | No | Fields for actions. Use 'all' or a comma-separated list: 'data', 'date', 'idMemberCreator', 'type'. | | `actions_limit` | string | No | Max actions per board (0-1000). | | `actions_since` | string | No | Actions after a date (e.g. '2024-01-01T00:00:00Z'), 'lastView', or 'null'. | | `actions_format` | string | No | Format for actions: 'count', 'list', or 'minimal'. | | `actions_entities` | string | No | Include entities (e.g., card, board, member) in action data. 'true' or 'false'. | | `organization_fields` | string | No | Fields for the organization if 'organization=true'. Use 'all' or a comma-separated list: 'billableMemberCount', 'desc', 'descData', 'displayName', 'idBoards', 'invitations', 'invited', 'logoHash', 'memberships', 'name', 'powerUps', 'prefs', 'premiumFeatures', 'products', 'url', 'website'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get organization by ID **Slug:** `TRELLO_GET_ORGANIZATIONS_BY_ID_ORG` Retrieves detailed information about a specific Trello organization, including optional related resources like members, boards, and actions, using its ID or unique name. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or unique name of the Trello organization to retrieve. | | `boards` | string | No | Filters the boards to return. Use 'all' or provide a comma-separated list of board states/types: closed, members, open, organization, pinned, public, starred, or unpinned. | | `fields` | string | No | Specifies the fields to return for the organization itself. Use 'all' or provide a comma-separated list of field names: billableMemberCount, desc, descData, displayName, idBoards, invitations, invited, logoHash, memberships, name, powerUps, prefs, premiumFeatures, products, url, or website. | | `actions` | string | No | Comma-separated list of action types (e.g., 'addMemberToBoard', 'createCard', 'updateOrganization') or 'all'. For a full list of types, consult the Trello API documentation. If not provided, Trello's default behavior applies. | | `members` | string | No | Filters which members of the organization to return. Valid values: 'admins', 'all', 'none', 'normal', 'owners'. | | `board_lists` | string | No | Filters the lists to be returned for each board. Valid values: 'all', 'closed', 'none', 'open'. | | `memberships` | string | No | Filters the memberships to return. Use 'all' or provide a comma-separated list of membership types: active, admin, deactivated, me, or normal. | | `board_fields` | string | No | Specifies the fields to return for each board. Use 'all' or provide a comma-separated list of field names: closed, dateLastActivity, dateLastView, desc, descData, idOrganization, invitations, invited, labelNames, memberships, name, pinned, powerUps, prefs, shortLink, shortUrl, starred, subscribed, or url. | | `paid_account` | string | No | Include organization's paid account status. Valid: 'true', 'false'. If not provided, this info is typically not included. | | `action_fields` | string | No | Specifies the fields to return for each action. Use 'all' or provide a comma-separated list of field names: data, date, idMemberCreator, or type. | | `actions_limit` | string | No | The maximum number of actions to return. Must be a number between 0 and 1000. | | `board_actions` | string | No | Comma-separated list of board action types (e.g., 'addAttachmentToCard', 'updateBoard') or 'all', specific to board actions. For a full list, consult the Trello API documentation. If not provided, Trello's default behavior applies. | | `member_fields` | string | No | Specifies the fields to return for each member. Use 'all' or provide a comma-separated list of field names: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, or username. | | `membersInvited` | string | No | Filters which invited (pending) members of the organization to return. Valid values: 'admins', 'all', 'none', 'normal', 'owners'. | | `actions_display` | string | No | Include a 'display' object with rendering info for each action. Valid: 'true', 'false'. If not provided, display info is typically not included. | | `member_activity` | string | No | Include member activity data (Trello Premium organizations only). Valid: 'true', 'false'. If not provided, activity is typically not included. | | `actions_entities` | string | No | Include an 'entities' object with details for each action. Valid: 'true', 'false'. If not provided, entities are typically not included. | | `memberships_member` | string | No | Include the member object for each membership. Valid: 'true', 'false'. If not provided, member objects are typically not included. | | `board_action_fields` | string | No | Specifies the fields to return for each board action. Use 'all' or provide a comma-separated list of field names: data, date, idMemberCreator, or type. | | `board_actions_limit` | string | No | The maximum number of board actions to return. Must be a number between 0 and 1000. | | `board_actions_since` | string | No | Retrieve board actions after a specific ISO 8601 date/time, 'null', or 'lastView'. If not provided, recent actions are typically returned. | | `board_actions_format` | string | No | Specifies the format for returning board actions. Valid values: 'count', 'list', 'minimal'. | | `board_actions_display` | string | No | Include a 'display' object for board actions. Valid: 'true', 'false'. If not provided, display info is typically not included. | | `membersInvited_fields` | string | No | Specifies the fields to return for each invited member. Use 'all' or provide a comma-separated list of field names: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, or username. | | `board_actions_entities` | string | No | Include an 'entities' object with details for board actions. Valid: 'true', 'false'. If not provided, entities are typically not included. | | `memberships_member_fields` | string | No | Specifies the member fields to return for memberships. Use 'all' or provide a comma-separated list of field names: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, or username. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get organization field by id **Slug:** `TRELLO_GET_ORGANIZATIONS_BY_ID_ORG_BY_FIELD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field to retrieve from the organization. Refer to Trello API documentation for a comprehensive list of valid fields. | | `idOrg` | string | Yes | The ID or name of the Trello organization. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get organization deltas by id **Slug:** `TRELLO_GET_ORGANIZATIONS_DELTAS_BY_ID_ORG` Retrieves a log of recent modifications (deltas) for a Trello organization, filterable by tags and supporting incremental fetching via an update index. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `tags` | string | Yes | Tag for filtering change types. Use 'all' to subscribe to all changes on the organization. | | `idOrg` | string | Yes | The ID or name of the Trello organization (workspace). | | `ixLastUpdate` | string | Yes | Sequence number of the last update received. Use '-1' for all changes since creation, or the value from 'modelIxUpdate' in a previous response for subsequent changes. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Retrieve organization members by id **Slug:** `TRELLO_GET_ORGANIZATIONS_MEMBERS_BY_ID_ORG` Retrieves members of a Trello organization (specified by ID or name), with an option to include member activity if the organization is Premium. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or name of the organization to retrieve members from. | | `fields` | string | No | Specifies which member fields to return. Use 'all' to include all available fields, or provide a comma-separated list of specific fields. Available fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | | `filter` | string | No | Determines which types of members to include in the response. 'admins' for administrators, 'all' for every member, 'none' for no members (useful for checking organization existence or permissions), 'normal' for regular members (excluding admins), 'owners' for organization owners. | | `activity` | string | No | Set to 'true' to include member activity information (e.g., lastActive timestamp). This option is only available for Premium organizations. Defaults to 'false' if not specified. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get organization memberships **Slug:** `TRELLO_GET_ORGANIZATIONS_MEMBERSHIPS_BY_ID_ORG` Fetches organization-level memberships for a Trello organization, with options to filter members and include their details; does not return board-specific memberships. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The unique identifier (ID) or name of the Trello organization for which to retrieve memberships. | | `filter` | string | No | Filters the list of memberships. Accepts 'all' or a comma-separated list of types: 'active', 'admin', 'deactivated', 'me', 'normal'. | | `member` | string | No | Whether to include full member objects in the response. Set to 'true' to include member details, 'false' to exclude. Defaults to 'false' if omitted. | | `member_fields` | string | No | Comma-separated list of member fields to return when 'member' is 'true'. Use 'all' for all fields, or specify individual fields. Available fields: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. Defaults to 'fullName,username' if omitted. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get invited organization members **Slug:** `TRELLO_GET_ORGANIZATIONS_MEMBERS_INVITED_BY_ID_ORG` 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 invitations. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or name of the Trello organization. Using the organization's unique ID is generally more reliable. | | `fields` | string | No | Determines the set of fields to be returned for each invited member. Specify 'all' to include all available fields, or provide a comma-separated list of desired fields. Valid fields include: avatarHash, avatarSource, bio, bioData, confirmed, email, fullName, gravatarHash, idBoards, idBoardsPinned, idOrganizations, idPremOrgsAdmin, initials, loginTypes, memberType, oneTimeMessagesDismissed, prefs, premiumFeatures, products, status, trophies, uploadedAvatarHash, url, or username. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get organization invited member field **Slug:** `TRELLO_GET_ORGANIZATIONS_MEMBERS_INVITED_BY_ID_ORG_BY_FIELD` Retrieves a specific `field` (e.g., fullName, username, email, status) for members with pending invitations to the Trello organization specified by `idOrg`. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field of an invited member to retrieve. This refers to an attribute of the invited member object. | | `idOrg` | string | Yes | The ID or name of the Trello organization. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get organization plugin data **Slug:** `TRELLO_GET_ORGANIZATIONS_PLUGIN_DATA` Tool to get organization-scoped pluginData on a Trello Workspace. Use when you need to retrieve plugin configuration or data stored at the organization level. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID or name of the organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get organization tags **Slug:** `TRELLO_GET_ORGANIZATIONS_TAGS_BY_ID` Lists all collections (tags) associated with a Trello organization. Use when you need to retrieve the organization's tags or collections. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID or name of the Organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get organization membership **Slug:** `TRELLO_GET_ORG_MEMBERSHIP` Retrieves a specific membership within a Trello organization, using their respective IDs, to ascertain the member's role, status, or permissions. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or name of the organization (workspace). Can be a 24-character hex ID like '6155b3f4a3a384789a7f1492' or the organization's short name like 'myteam'. | | `member` | string | No | Determines whether to include the member object in the response. Valid values are 'true' or 'false'. | | `idMembership` | string | Yes | The ID of the membership to retrieve. | | `member_fields` | string | No | Comma-separated list of fields for the member object. Valid values: 'all', 'avatarHash', 'bio', 'bioData', 'confirmed', 'fullName', 'idPremOrgsAdmin', 'initials', 'memberType', 'products', 'status', 'url', 'username'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get new billable guests **Slug:** `TRELLO_GET_ORG_NEW_BILLABLE_GUESTS_BY_BOARD` Tool to check for new billable guests on a board within an organization. Use when you need to identify members who will incur billing charges. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID or name of the organization. | | `idBoard` | string | Yes | The ID of the board to check for new billable guests. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Search Trello **Slug:** `TRELLO_GET_SEARCH` Searches Trello content (e.g., boards, cards, members) within specified organizations using a query and customizable result fields. IMPORTANT LIMITATIONS: - Search indexing has a delay: newly created/updated cards may not appear for several minutes. - For exact name matching or time-sensitive lookups, use TRELLO_GET_LISTS_CARDS_BY_ID_LIST or TRELLO_GET_BOARDS_CARDS_BY_ID_BOARD to enumerate cards directly, then filter by name. - The search uses word tokenization: queries like 'Payment failed when sending tips' are split into individual terms ['Payment', 'failed', 'when', 'sending', 'tips']. Common words may be ignored. - Set partial='true' (default) for better recall with prefix matching on the last search term. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `query` | string | Yes | The search query string. Trello tokenizes the query into individual words and searches for cards/boards/etc. containing those terms. Note: Common words like 'when', 'the', 'is' may be ignored as stop words. | | `idCards` | string | No | A comma-separated list of card IDs to search for. Each card ID must be a 24-character hexadecimal string (e.g., '5f9f1b9b8f8f8f8f8f8f8f8f'). Do NOT use the short card ID from the card URL. | | `partial` | string | No | Enable partial/prefix matching for search terms ('true' or 'false'). Default is 'true'. When true, the last word in the query will match word prefixes (e.g., 'pay' matches 'payment'). When false, only exact word matches are returned. Setting to 'true' (recommended) improves search recall, especially for card names that may not be indexed immediately after creation. | | `idBoards` | string | No | A comma-separated list of board IDs to search within, or 'mine' to search all boards the user is a member of (default). Each board ID must be a 24-character hexadecimal string (e.g., '5f9f1b9b8f8f8f8f8f8f8f8f'). Do NOT use the short 8-character ID from the board URL (e.g., 'VGflYpta' from 'trello.com/b/VGflYpta/board-name'). To get the correct ID, use the TRELLO_GET_BOARDS_BY_ID_MEMBER action or extract it from API responses. | | `card_list` | string | No | Whether to include the list object for each card returned ('true' or 'false'). | | `card_board` | string | No | Whether to include the board object for each card returned ('true' or 'false'). | | `cards_page` | string | No | Page number for paginated card results. Must be 0-100. Default is 0. | | `modelTypes` | string | No | Types of Trello objects to search (e.g., 'cards,boards' or 'all' from 'actions', 'boards', 'cards', 'members', 'organizations'). Default is 'all'. | | `card_fields` | string | No | Fields for found cards; 'all' or a comma-separated list (e.g., 'name,due'). Default is 'all'. | | `cards_limit` | string | No | Maximum number of card results (1-1000). Use 0 to exclude cards from search results. Default is 10. | | `board_fields` | string | No | Fields for found boards; 'all' or a comma-separated list (e.g., 'name,url'). Default is 'name,idOrganization'. | | `boards_limit` | string | No | Maximum number of board results (1-1000). Use 0 to exclude boards from search results. Default is 10. | | `card_members` | string | No | Whether to include member objects for each card returned ('true' or 'false'). | | `card_stickers` | string | No | Whether to include sticker objects for each card returned ('true' or 'false'). | | `member_fields` | string | No | Fields for found members; 'all' or a comma-separated list (e.g., 'fullName,username'). Default is 'avatarHash,fullName,initials,username,confirmed'. | | `members_limit` | string | No | Maximum number of member results (1-1000). Use 0 to exclude members from search results. Default is 10. | | `idOrganizations` | string | No | A comma-separated list of organization (workspace) IDs to search within. Each organization ID must be a 24-character hexadecimal string (e.g., '5f9f1b9b8f8f8f8f8f8f8f8f'). | | `card_attachments` | string | No | Whether to include attachments for cards ('true', 'false', or 'cover' for card cover attachments). | | `organization_fields` | string | No | Fields for found organizations; 'all' or a comma-separated list (e.g., 'name,url'). Default is 'name,displayName'. | | `organizations_limit` | string | No | Maximum number of organization results (1-1000). Use 0 to exclude organizations from search results. Default is 10. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Search for members **Slug:** `TRELLO_GET_SEARCH_MEMBERS` Searches Trello members by name, username, or email, optionally scoped to a board or organization. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | string | No | Maximum number of member records to return (string '1'-'20'). Default is 8. | | `query` | string | Yes | Search query for Trello members by name, username, or email (1-16384 characters). | | `idBoard` | string | No | Optional board ID to scope the search to members relevant to that board. | | `idOrganization` | string | No | Optional organization/workspace ID to scope the search to that organization. | | `onlyOrgMembers` | string | No | When 'true' and idOrganization is provided, only return members of that organization. Values: 'true' or 'false'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get sessions socket **Slug:** `TRELLO_GET_SESSIONS_SOCKET` Retrieves WebSocket session connection information from Trello for real-time updates. IMPORTANT: This endpoint is an internal Trello endpoint that is NOT part of the public REST API. It requires WebSocket protocol and browser session authentication, making it inaccessible via standard API tokens. For real-time updates, use Trello Webhooks instead. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get token by token **Slug:** `TRELLO_GET_TOKENS_BY_TOKEN` Retrieves information about a specific Trello API token, allowing selection of specific fields and inclusion of webhook details. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `token` | string | Yes | The Trello API token string to query. Must be the full token value (e.g., 'ATTA...'). | | `fields` | string | No | Comma-separated string of fields to include (e.g., 'dateCreated,idMember') or 'all'. Valid fields: 'dateCreated', 'dateExpires', 'idMember', 'identifier', 'permissions'. | | `webhooks` | string | No | String 'true' or 'false' to include webhook information. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get token field **Slug:** `TRELLO_GET_TOKENS_BY_TOKEN_BY_FIELD` Retrieves a specific field from a Trello token, provided the token is valid, has necessary permissions, and the field is a valid token field. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field of the token to retrieve (e.g., 'identifier', 'idMember', 'dateCreated', 'dateExpires', 'permissions'). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get token member **Slug:** `TRELLO_GET_TOKENS_MEMBER_BY_TOKEN` Retrieves information about the Trello member associated with the current API token, allowing customization of the returned fields. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | string | No | Specifies the member fields to return. Use 'all' for all fields, or a comma-separated list of specific field names. Available fields: avatarHash, avatarSource, bio, bioData, confirmed, email, fullName, gravatarHash, idBoards, idBoardsPinned, idOrganizations, idPremOrgsAdmin, initials, loginTypes, memberType, oneTimeMessagesDismissed, prefs, premiumFeatures, products, status, trophies, uploadedAvatarHash, url, username. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Retrieve token member field **Slug:** `TRELLO_GET_TOKENS_MEMBER_BY_TOKEN_BY_FIELD` Retrieves a specific field for the Trello member associated with the current API token. The token is automatically extracted from authentication, so only the field name needs to be specified. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific member field to retrieve. Valid fields include: id, username, fullName, email, avatarHash, avatarUrl, avatarSource, bio, bioData, confirmed, initials, memberType, activityBlocked, idBoards, idBoardsPinned, idOrganizations, idPremOrgsAdmin, idEnterprise, idEnterprisesDeactivated, idMemberReferrer, loginTypes, oneTimeMessagesDismissed, prefs, premiumFeatures, products, status, trophies, uploadedAvatarHash, url, gravatarHash, nonPublic. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get webhooks for token **Slug:** `TRELLO_GET_TOKENS_WEBHOOKS_BY_TOKEN` Retrieves all webhooks associated with a specific Trello API token. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get token webhook by ID **Slug:** `TRELLO_GET_TOKENS_WEBHOOKS_BY_TOKEN_BY_ID_WEBHOOK` Retrieves detailed information for a specific Trello webhook, identified by `idWebhook`, that is associated with the given `token`. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idWebhook` | string | Yes | The unique identifier (ID) of the webhook whose details are to be retrieved. This ID is typically a 24-character hexadecimal string. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get type by id **Slug:** `TRELLO_GET_TYPES_BY_ID` Identifies the type of a Trello resource (member or organization) given its ID. Returns a 'type' field indicating whether the resource is a 'member' or 'organization'. Note: This endpoint only works for members and organizations; boards, cards, and lists are not supported. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID of a Trello resource (member or organization) to identify its type. Use 'me' for the current authenticated user, a member ID (24-character hex string), or an organization ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get webhook by ID **Slug:** `TRELLO_GET_WEBHOOKS_BY_ID_WEBHOOK` Retrieves the full configuration and status for a specific Trello webhook by its unique ID; this action does not return past notification history. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idWebhook` | string | Yes | The unique identifier (ID) of the Trello webhook to retrieve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get webhook field by id **Slug:** `TRELLO_GET_WEBHOOKS_BY_ID_WEBHOOK_BY_FIELD` Gets a specific field's value from a Trello webhook, avoiding retrieval of the full webhook object. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string | Yes | The specific field to retrieve from the webhook object. Valid fields are: 'description', 'idModel', 'callbackURL', 'active', 'consecutiveFailures', 'firstConsecutiveFailDate'. Note: 'id' is NOT a valid field for this endpoint. | | `idWebhook` | string | Yes | The unique identifier of the Trello webhook. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List available emoji **Slug:** `TRELLO_LIST_EMOJI` Tool to list all available emoji in Trello. Use when you need to browse or search for emoji to use in cards, comments, or reactions. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `locale` | string | No | The locale to return emoji descriptions and names in. Defaults to the logged in member's locale. | | `spritesheets` | boolean | No | `true` to return spritesheet URLs in the response | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Mark all notifications as read **Slug:** `TRELLO_MARK_ALL_NOTIFICATIONS_READ` Marks all Trello notifications for the authenticated user as read across all boards; this action is permanent and cannot be undone. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Mark board as viewed **Slug:** `TRELLO_MARK_BOARD_AS_VIEWED` 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 settings. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idBoard` | string | Yes | The unique identifier of the Trello board to be marked as viewed. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Mark card notifications read **Slug:** `TRELLO_MARK_CARD_NOTIFICATIONS_READ` Marks all notifications associated with a specific Trello card as read; this is irreversible and only affects read status, not deleting or modifying notifications. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idCard` | string | Yes | The ID or short link of the card whose associated notifications are to be marked as read. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Move all cards in list to another list **Slug:** `TRELLO_MOVE_ALL_LIST_CARDS` Moves all cards from a source Trello list to a destination list on a specified board. This action is irreversible, moves (not copies) cards, and empties the source list without deleting it. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idList` | string | Yes | The ID of the source Trello list from which all cards will be moved. This is used in the path parameter. | | `idBoard` | string | Yes | The ID of the destination Trello board to which all cards from the source list will be moved. This parameter is required by Trello for this operation. | | `idListDestination` | string | Yes | The ID of the destination Trello list on the destination board to which all cards from the source list will be moved. This parameter is required by Trello for this operation. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete member from board **Slug:** `TRELLO_REMOVE_BOARD_MEMBER` Permanently removes a current member from a Trello board, revoking their access; this action is irreversible. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idBoard` | string | Yes | The ID of the board from which the member will be removed. | | `idMember` | string | Yes | The ID of the member to remove from the board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete member board star **Slug:** `TRELLO_REMOVE_BOARD_STAR` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idMember` | string | Yes | The ID or username of the Trello member. | | `idBoardStar` | string | Yes | The ID of the board star. This uniquely identifies the 'starred' relationship between the member and a board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete card label by color **Slug:** `TRELLO_REMOVE_CARD_LABEL_BY_COLOR` 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 definition itself. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `color` | string | Yes | The specific color of the label to remove from the card. Standard Trello label colors are used (e.g., 'red', 'blue'). | | `idCard` | string | Yes | The ID or short link of the Trello card. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Remove label from card **Slug:** `TRELLO_REMOVE_LABEL_FROM_CARD` Removes a specific label from a Trello card; the label itself is not deleted from the board, only its association with the card. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idCard` | string | Yes | The ID or short link of the card from which the label will be removed. | | `idLabel` | string | Yes | The ID of the label to be removed from the card. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Remove member from card **Slug:** `TRELLO_REMOVE_MEMBER_FROM_CARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idCard` | string | Yes | The ID or shortLink of the card from which the member will be removed. | | `idMember` | string | Yes | The ID of the member to be unassigned from the card. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete member from organization **Slug:** `TRELLO_REMOVE_MEMBER_FROM_ORG` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or short name (slug) of the organization. | | `idMember` | string | Yes | The ID of the member to remove from the organization. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update action text **Slug:** `TRELLO_UPDATE_ACTIONS_BY_ID_ACTION` Updates the `text` field of a specific Trello comment action, identified by `idAction`. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `text` | string | No | The new text content for the action (comment). Must be a string with a length from 1 to 16384 characters. | | `idAction` | string | Yes | The unique identifier of the action (comment) to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update action text **Slug:** `TRELLO_UPDATE_ACTIONS_TEXT_BY_ID_ACTION` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new text content for the action. This string must have a length between 1 and 16384 characters, inclusive. | | `idAction` | string | Yes | The unique identifier of the Trello action (e.g., a comment or card update) whose text needs to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board membership **Slug:** `TRELLO_UPDATE_BOARD_MEMBERSHIP` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | string | No | New role for the member on the board, determining their permissions. Must be 'admin', 'normal', or 'observer'. | | `idBoard` | string | Yes | Unique identifier of the Trello board. | | `idMembership` | string | Yes | Unique identifier of the membership to be updated. | | `member_fields` | string | No | Fields for the member to include in the response. Use 'all' or a comma-separated list (e.g., avatarHash, bio, fullName). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board by ID **Slug:** `TRELLO_UPDATE_BOARDS_BY_ID_BOARD` Updates attributes (e.g., name, description, status, preferences) of an existing Trello board identified by `idBoard`. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `desc` | string | No | New board description (max 16384 characters). An empty string removes the current description. | | `name` | string | No | New name for the board (1-16384 characters). | | `closed` | string | No | Set to 'true' to close (archive) the board, or 'false' to re-open. | | `idBoard` | string | Yes | The ID of the Trello board to update. | | `powerUps` | string | No | Power-Ups to enable (e.g., 'calendar,voting', 'all'). Valid: `calendar`, `cardAging`, `recap`, `voting`. | | `subscribed` | string | No | 'true' or 'false' for the authenticated user to be subscribed to the board. | | `prefs_voting` | string | No | Voting permissions. Maps to API parameter 'prefs_voting'. Allowed values: `disabled`, `members`, `observers`, `org`, `public`. | | `idBoardSource` | string | No | ID of an existing board to copy settings (e.g., lists, labels) from. | | `prefs__voting` | string | No | Voting permissions. Maps to API parameter 'prefs/voting'. Allowed values: `disabled`, `members`, `observers`, `org`, `public`. | | `idOrganization` | string | No | ID or name of the Trello Workspace to associate with this board. | | `keepFromSource` | string | No | Comma-separated components to copy from `idBoardSource` (e.g., 'cards,labels', 'all'). Defaults to 'cards' if `idBoardSource` is set. Valid: `cards`, `lists`, `members`, `checklists`, `comments`, `labels`, `stickers`, `attachments`. | | `prefs_comments` | string | No | Commenting permissions. Maps to API parameter 'prefs_comments'. Allowed values: `disabled`, `members`, `observers`, `org`, `public`. | | `prefs_selfJoin` | string | No | Enables or disables self-join for Workspace members. Maps to API parameter 'prefs_selfJoin'. Set to 'true' or 'false'. | | `labelNames__red` | string | No | Custom name for the red label (max 16384 chars). Maps to API parameter 'labelNames/red'. | | `prefs__comments` | string | No | Commenting permissions. Maps to API parameter 'prefs/comments'. Allowed values: `disabled`, `members`, `observers`, `org`, `public`. | | `prefs__selfJoin` | string | No | Enable or disable self-join for Workspace members. Maps to API parameter 'prefs/selfJoin'. Set to 'true' or 'false'. | | `prefs_cardAging` | string | No | Card aging style. Maps to API parameter 'prefs_cardAging'. Allowed values: `pirate`, `regular`. | | `labelNames__blue` | string | No | Custom name for the blue label (max 16384 chars). Maps to API parameter 'labelNames/blue'. | | `prefs__cardAging` | string | No | Card aging style. Maps to API parameter 'prefs/cardAging'. Allowed values: `pirate`, `regular`. | | `prefs_background` | string | No | Board background. Maps to API parameter 'prefs_background'. Can be a color name, a custom background ID, or a Trello photo ID. Max length: 16384 characters. | | `prefs_cardCovers` | string | No | Enables or disables card covers. Maps to API parameter 'prefs_cardCovers'. Set to 'true' or 'false'. | | `labelNames__green` | string | No | Custom name for the green label (max 16384 chars). Maps to API parameter 'labelNames/green'. | | `prefs__background` | string | No | Board background. Maps to API parameter 'prefs/background'. Use a standard Trello background name (e.g., 'blue', 'orange', 'green', 'red', 'purple', 'pink', 'lime', 'sky', 'grey') or the ID of a custom background image. | | `prefs__cardCovers` | string | No | Enable or disable card covers. Maps to API parameter 'prefs/cardCovers'. Set to 'true' or 'false'. | | `prefs_invitations` | string | No | Invitation permissions. Maps to API parameter 'prefs_invitations'. Allowed values: `admins`, `members`. | | `labelNames__orange` | string | No | Custom name for the orange label (max 16384 chars). Maps to API parameter 'labelNames/orange'. | | `labelNames__purple` | string | No | Custom name for the purple label (max 16384 chars). Maps to API parameter 'labelNames/purple'. | | `labelNames__yellow` | string | No | Custom name for the yellow label (max 16384 chars). Maps to API parameter 'labelNames/yellow'. | | `prefs__invitations` | string | No | Invitation permissions. Maps to API parameter 'prefs/invitations'. Allowed values: `admins`, `members`. | | `prefs_permissionLevel` | string | No | Board's visibility and permission level. Maps to API parameter 'prefs_permissionLevel'. Allowed values: `org`, `private`, `public`. | | `prefs__permissionLevel` | string | No | Board visibility and permission level. Maps to API parameter 'prefs/permissionLevel'. Allowed values: `org` (Workspace-visible), `private`, `public`. | | `prefs__calendarFeedEnabled` | string | No | Enable or disable the iCalendar feed. Maps to API parameter 'prefs/calendarFeedEnabled'. Set to 'true' or 'false'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board closed status **Slug:** `TRELLO_UPDATE_BOARDS_CLOSED_BY_ID_BOARD` Archives (closes) an active Trello board or reopens a previously archived board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The desired closed state for the board. Set to the string 'true' to close (archive) the board, or the string 'false' to reopen it. | | `idBoard` | string | Yes | The ID of the Trello board to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board description **Slug:** `TRELLO_UPDATE_BOARDS_DESC_BY_ID_BOARD` Updates the description of a specified Trello board; the update is immediate and does not affect other board elements like lists, cards, or membership. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new description for the board. Must be a string with a length between 0 and 16384 characters. Providing an empty string ("") will clear the board's description. If `null` is sent or the field is omitted, Trello's behavior might vary, potentially leaving the description unchanged or clearing it; use an empty string for an explicit clear. | | `idBoard` | string | Yes | The unique identifier of the Trello board whose description will be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board sidebar actions preferences **Slug:** `TRELLO_UPDATE_BOARD_SIDEBAR_ACTIONS_PREFS` Updates the current user's preference for the visibility of sidebar board actions on a specific Trello board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | Controls the visibility of sidebar board actions. Use 'true' to show them, 'false' to hide them. | | `idBoard` | string | Yes | The unique identifier of the Trello board for which the 'showSidebarBoardActions' preference is being updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update my board sidebar activity preference **Slug:** `TRELLO_UPDATE_BOARD_SIDEBAR_ACTIVITY_PREFS` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | Determines the visibility of the sidebar activity. Set to 'true' to show the activity feed, or 'false' to hide it. | | `idBoard` | string | Yes | The unique identifier of the Trello board whose sidebar activity visibility preference is to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board sidebar members preference **Slug:** `TRELLO_UPDATE_BOARD_SIDEBAR_MEMBERS_PREF` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | Determines whether to show members in the board sidebar. Set to 'true' to show members, or 'false' to hide them. This is a per-user preference. | | `idBoard` | string | Yes | The unique identifier of the Trello board for which the sidebar member visibility preference will be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board organization **Slug:** `TRELLO_UPDATE_BOARDS_ID_ORGANIZATION_BY_ID_BOARD` Moves an existing Trello board to a specified, existing Trello organization, which can affect the board's visibility and member access. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The ID of the new Trello organization to which the board will be moved. Must be a string with a length between 0 and 16384 characters. An empty string may be used to attempt to remove the board from its current organization, if the Trello API supports this behavior. | | `idBoard` | string | Yes | The ID of the Trello board to be moved to a new organization. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update a board's blue label name **Slug:** `TRELLO_UPDATE_BOARDS_LABEL_NAMES_BLUE_BY_ID_BOARD` Sets the name of the blue label for a Trello board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new name for the blue label. Must be a string with a length from 0 to 16384 characters. An empty string can be used to remove the current name. | | `idBoard` | string | Yes | The unique identifier of the Trello board whose blue label name is to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board's green label name **Slug:** `TRELLO_UPDATE_BOARDS_LABEL_NAMES_GREEN_BY_ID_BOARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new name for the green label (0-16384 characters). An empty string may reset the name or cause an error. | | `idBoard` | string | Yes | The ID of the Trello board for which the green label name will be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board label orange name **Slug:** `TRELLO_UPDATE_BOARDS_LABEL_NAMES_ORANGE_BY_ID_BOARD` Updates the name of the orange label for a specified Trello board. This action finds the orange label on the specified board and updates its name. Only the label's name is affected, not its color or associated cards. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new name for the orange label. It must be a string with a length from 0 to 16384 characters. An empty string will remove the current custom name. | | `idBoard` | string | Yes | The unique identifier of the Trello board whose orange label name is to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update purple label name **Slug:** `TRELLO_UPDATE_BOARDS_LABEL_NAMES_PURPLE_BY_ID_BOARD` Updates the name of the purple label on a Trello board. This action first retrieves the purple label from the board, then updates its name. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new name to be assigned to the purple label. This string must have a length between 0 and 16384 characters. An empty string can be used to clear the existing custom name. | | `idBoard` | string | Yes | The unique identifier of the Trello board where the purple label's name will be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update red label name **Slug:** `TRELLO_UPDATE_BOARDS_LABEL_NAMES_RED_BY_ID_BOARD` Updates the name of the red label on a Trello board. This action first retrieves the red label from the board, then updates its name. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new name to be assigned to the red label. This string must have a length between 0 and 16384 characters. An empty string can be used to clear the existing custom name. | | `idBoard` | string | Yes | The unique identifier of the Trello board where the red label's name will be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update yellow label name on board **Slug:** `TRELLO_UPDATE_BOARDS_LABEL_NAMES_YELLOW_BY_ID_BOARD` Updates the name of a board's yellow label; other colored labels are unaffected. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new name for the yellow label. Must be a string with a length between 0 and 16384 characters. An empty string ("") will remove the current name of the label. | | `idBoard` | string | Yes | The ID of the Trello board where the yellow label name will be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board members **Slug:** `TRELLO_UPDATE_BOARDS_MEMBERS_BY_ID_BOARD` Adds or updates a member's role on a specific Trello board, typically requiring the member's `email` and a membership `type`. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | string | No | Role to assign to the member on the board, determining permissions. Typically required by Trello. | | `email` | string | No | Email address of the user to add or update. Typically required by Trello. | | `idBoard` | string | Yes | The unique identifier of the Trello board. | | `fullName` | string | No | Full name for a new user invitation; must be >=1 character and no leading/trailing spaces. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board member attributes **Slug:** `TRELLO_UPDATE_BOARDS_MEMBERS_BY_ID_BOARD_BY_ID_MEMBER` 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 Trello profile. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | string | No | New role for the member on this board, determining their permissions. | | `email` | string | No | New board-specific email address for the member; does not change their global Trello account email. | | `idBoard` | string | Yes | ID of the board. | | `fullName` | string | No | New board-specific full name for the member; must be >=1 character and not start/end with a space. | | `idMember` | string | Yes | ID of the member to update. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Modify board email position preference **Slug:** `TRELLO_UPDATE_BOARDS_MY_PREFS_EMAIL_POSITION_BY_ID_BOARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | Position where new cards created via email will be placed in the list. Valid values are 'top' (card appears at the top of the list) or 'bottom' (card appears at the bottom of the list). | | `idBoard` | string | Yes | The unique identifier of the Trello board for which to update the email position preference. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board email list preference **Slug:** `TRELLO_UPDATE_BOARDS_MY_PREFS_ID_EMAIL_LIST_BY_ID_BOARD` Sets the default Trello list where cards created via email will be added for a specific board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | ID of an existing list on the board where cards created via email will be added. Must be a valid list ID that belongs to this board. | | `idBoard` | string | Yes | ID of the board whose email-to-list preference will be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board show list guide preference **Slug:** `TRELLO_UPDATE_BOARDS_MY_PREFS_SHOW_LIST_GUIDE_BY_ID_BOARD` DEPRECATED: Updates the 'Show List Guide' preference for a specified Trello board. WARNING: This endpoint has been deprecated by Trello (CHANGE-2651, June 2025) and returns 'Cannot PUT' errors. The showListGuide preference is no longer actively used in Trello's application. While the preference still appears in GET /boards/{id}/myPrefs responses, the PUT endpoint for updating it has been removed from Trello's API. Consider using other board preference endpoints like showSidebar, showSidebarActivity, showSidebarMembers, or showSidebarBoardActions which remain functional. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | Determines whether the list guide is shown; use 'true' to display or 'false' to hide. | | `idBoard` | string | Yes | The unique identifier of the Trello board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board sidebar visibility **Slug:** `TRELLO_UPDATE_BOARDS_MY_PREFS_SHOW_SIDEBAR_BY_ID_BOARD` Updates the authenticated user's personal preference for showing or hiding the sidebar on a specific Trello board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | Boolean string to control sidebar visibility. Set to 'true' to show the sidebar, or 'false' to hide it. | | `idBoard` | string | Yes | The ID of the board for which to update the sidebar visibility preference. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board name **Slug:** `TRELLO_UPDATE_BOARDS_NAME_BY_ID_BOARD` Updates the name of an existing Trello board, identified by `idBoard`; this change only affects the board's name, not its other attributes. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new name for the board. Must be a string with a length between 1 and 16384 characters. | | `idBoard` | string | Yes | The unique identifier of the Trello board whose name is to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board background **Slug:** `TRELLO_UPDATE_BOARDS_PREFS_BACKGROUND_BY_ID_BOARD` Updates the cosmetic background preference for a specific Trello board; this change does not affect board functionality or content. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The standard background name (e.g., 'blue', 'pink', 'grey', 'green', 'orange', 'purple', 'sky', 'rose', 'lime', 'lake', 'mountains', 'forest', 'beach', 'city') or the ID of a previously uploaded custom background. If not provided or set to null/empty string, Trello may revert to a default or existing background based on its internal logic. | | `idBoard` | string | Yes | The ID of the board for which the background preference will be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board calendar feed enabled status **Slug:** `TRELLO_UPDATE_BOARDS_PREFS_CALENDAR_FEED_ENABLED_BY_ID_BOARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | A string value that enables or disables the calendar feed. Set to 'true' to enable, or 'false' to disable. | | `idBoard` | string | Yes | The ID of the Trello board for which to update the calendar feed preference. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board card aging preference **Slug:** `TRELLO_UPDATE_BOARDS_PREFS_CARD_AGING_BY_ID_BOARD` Updates the card aging visual preference to 'pirate' or 'regular' mode for a specified Trello board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The card aging preference to set for the board. 'pirate' mode makes cards visually age (yellow, tear, and crack) over time to indicate inactivity, while 'regular' mode uses a standard visual representation. | | `idBoard` | string | Yes | The ID of the Trello board for which to update the card aging preference. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board card cover preference **Slug:** `TRELLO_UPDATE_BOARDS_PREFS_CARD_COVERS_BY_ID_BOARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | Required. The desired state for card covers on the board. Set to 'true' to enable (show) card covers, or 'false' to disable (hide) them. | | `idBoard` | string | Yes | The ID of the Trello board for which the card cover display preference will be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board comment preferences **Slug:** `TRELLO_UPDATE_BOARDS_PREFS_COMMENTS_BY_ID_BOARD` Changes the permission settings for who can add comments to cards on a specific Trello board, without affecting other board settings. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The permission level for who can add comments to cards. Valid values: 'disabled' (no comments allowed), 'members' (only board members). Additional values 'observers', 'org', or 'public' may be available depending on board visibility settings. | | `idBoard` | string | Yes | The unique identifier of the Trello board whose comment preferences are to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board invitation preferences **Slug:** `TRELLO_UPDATE_BOARDS_PREFS_INVITATIONS_BY_ID_BOARD` Updates who can invite new members ('admins' or 'members') to a specific Trello board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | Determines who can invite new members to the board: 'admins' (only administrators) or 'members' (all current members). | | `idBoard` | string | Yes | Identifier of the Trello board whose invitation preferences will be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board prefs permission level **Slug:** `TRELLO_UPDATE_BOARDS_PREFS_PERMISSION_LEVEL_BY_ID_BOARD` 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 for it. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new permission level for the board. Must be one of 'private' (board visible only to members), 'org' (board visible to organization/workspace members), or 'public' (board visible to anyone). | | `idBoard` | string | Yes | The ID of the Trello board whose permission level preference is to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board self-join preference **Slug:** `TRELLO_UPDATE_BOARDS_PREFS_SELF_JOIN_BY_ID_BOARD` Updates a board's 'selfJoin' preference, determining if members can join freely or must be invited. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | Specifies the new 'selfJoin' preference for the board. Provide the string 'true' to enable users to join the board on their own, or 'false' to make the board invite-only. This parameter is required. | | `idBoard` | string | Yes | The unique identifier (ID) of the Trello board whose 'selfJoin' preference is to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board voting preferences **Slug:** `TRELLO_UPDATE_BOARDS_PREFS_VOTING_BY_ID_BOARD` Sets who can vote on cards for an existing Trello board, changing only the voting preferences for all cards on the board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The desired voting permission level for the board. Determines who can vote on cards. Allowed values: 'disabled' (voting is disabled), 'members' (only board members can vote), 'observers' (board members and observers can vote), 'org' (members of the organization to which the board belongs can vote), or 'public' (any Trello user can vote). | | `idBoard` | string | Yes | The unique identifier of the Trello board for which to update voting preferences. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board subscription status **Slug:** `TRELLO_UPDATE_BOARDS_SUBSCRIBED_BY_ID_BOARD` Updates the authenticated user's subscription status (subscribe/unsubscribe for notifications) for a specified Trello board, to which the user must have access. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | Required. The new subscription status. Set to 'true' to subscribe to the board (receive notifications), or 'false' to unsubscribe (stop receiving notifications). | | `idBoard` | string | Yes | The ID of the Trello board for which to update the subscription status. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update board star position **Slug:** `TRELLO_UPDATE_BOARD_STARS_POSITION_BY_ID_MEMBER_BY_ID_BOARD_` Update board star position #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new position for the starred board. Valid inputs are the literal strings 'top', 'bottom', or a string representing a positive number (e.g., '1', '2.5', '10'). | | `idMember` | string | Yes | The ID or username of the Trello member. The special value 'me' can be used to refer to the currently authenticated user. | | `idBoardStar` | string | Yes | The unique identifier of the specific board star whose position is to be changed. Each board starred by a member has a unique `idBoardStar`. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update card comment **Slug:** `TRELLO_UPDATE_CARDS_ACTIONS_COMMENTS_BY_ID_CARD_BY_ID_ACTION` Updates the text for a given comment action (`idAction`) on a specified card (`idCard`), affecting only the text content. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `text` | string | No | The new text for the comment (1-16384 characters). | | `idCard` | string | Yes | The ID or short link of the card containing the comment to be updated. | | `idAction` | string | Yes | The ID of the comment action to be updated. In Trello, a comment on a card is an action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update card attributes **Slug:** `TRELLO_UPDATE_CARDS_BY_ID_CARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `due` | string | No | The new due date for the card, in ISO 8601 format, or 'null' to remove the due date. | | `pos` | string | No | The new position of the card within its list. Can be 'top', 'bottom', or a positive floating-point number. Higher numbers are further down the list. | | `desc` | string | No | The new description for the card. String length must be from 0 to 16384 characters. | | `name` | string | No | The new name for the card. Required if not copying the name from `idCardSource`, `fileSource`, or `urlSource`. | | `closed` | string | No | Determines whether the card should be archived (closed). Accepts boolean (true/false) or string ('true'/'false'). | | `idCard` | string | Yes | The ID or shortLink of the card to update. | | `idList` | string | No | The ID of the list to move the card to. | | `labels` | string | No | Comma-separated list of label colors (e.g., 'green,yellow,red') to apply, overwriting existing labels. Use 'idLabels' for more precise control. 'all' may add all available label colors. | | `idBoard` | string | No | The ID of the board to move the card to. If `idList` is also provided, the card will be moved to that list on the new board. | | `idLabels` | string | No | Comma-separated list of label IDs to apply, replacing existing labels. To preserve existing labels, fetch current `idLabels`, append new ones, and submit the combined list. | | `idMembers` | string | No | Comma-separated list of member IDs to assign, replacing existing members. To preserve existing members, fetch current `idMembers`, append new ones, and submit the combined list. | | `urlSource` | string | No | A URL to be attached to the card (e.g., a link to an external resource). If the card is being created from a URL (e.g. via a bookmarklet), this will be the source URL. Set to 'null' or an empty string to remove an existing attachment link created this way. | | `fileSource` | string | No | The URL of a file to be attached to the card. Trello will fetch and attach the file from this URL. | | `subscribed` | string | No | Determines whether the user is subscribed to the card. Accepts boolean (true/false) or string ('true'/'false'). | | `idCardSource` | string | No | The ID of a card to copy properties from. Requires `keepFromSource` to be specified. | | `keepFromSource` | string | No | If `idCardSource` is specified, this is a comma-separated list of properties to copy from the source card. Valid values are 'all', or any combination of 'attachments', 'checklists', 'comments', 'customFields', 'due', 'labels', 'members', 'pluginData', 'stickers'. | | `idAttachmentCover` | string | No | The ID of an existing image attachment to be used as the card cover. Use 'null' or an empty string to remove the cover. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update check item on card **Slug:** `TRELLO_UPDATE_CARDS_CHECKLIST_ITEMS_BY_ID_CARD_BY_ID_CHECKLI` Update check item on card #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID of the Card | | `due` | string | No | A due date for the checkitem in ISO 8601 format (e.g., '2021-02-12T07:00:00.000Z') | | `pos` | string | No | Position of the check item: 'top', 'bottom', or a positive float | | `name` | string | No | The new name for the checklist item | | `state` | string ("complete" | "incomplete") | No | State of a check item. | | `idMember` | string | No | The ID of the member to assign to this check item | | `dueReminder` | integer | No | A dueReminder for the due date on the checkitem (number of seconds before due date) | | `idCheckItem` | string | Yes | The ID of the checkitem | | `idChecklist` | string | No | The ID of the checklist this item is in | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update checklist item position **Slug:** `TRELLO_UPDATE_CARDS_CHECKLIST_ITEMS_POSITION_BY_ID_CARD_BY_I` Update checklist item position #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | Required. New position for the check item: 'top', 'bottom', or a positive integer. 'top' moves to the beginning of the checklist, 'bottom' to the end, and a numeric value sets the exact position. | | `idCard` | string | Yes | ID or short link of the card containing the checklist. | | `idCheckItem` | string | Yes | ID of the check item to move. | | `idChecklist` | string | Yes | ID of the checklist containing the item to be moved. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update card checklist item state **Slug:** `TRELLO_UPDATE_CARDS_CHECKLIST_ITEMS_STATE_BY_ID_CARD_BY_ID_C` Update card checklist item state #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new state for the check item. Use 'complete' or 'true' to mark as complete, and 'incomplete' or 'false' to mark as incomplete. | | `idCard` | string | Yes | The ID or short link of the Trello card containing the checklist item. | | `idCheckItem` | string | Yes | The ID of the check item within the checklist whose state needs to be updated. | | `idChecklist` | string | Yes | The ID of the checklist on the card that contains the check item to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update checklist item name in card **Slug:** `TRELLO_UPDATE_CARDS_CHECKLISTS_CHECK_ITEMS_NAME_BY_ID_CARD_B` Update checklist item name in card #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | New name for the check item (1-16384 characters). | | `idCard` | string | Yes | ID or shortLink of the card containing the checklist and item. | | `idCheckItem` | string | Yes | ID of the check item within the specified checklist to rename. | | `idChecklist` | string | Yes | ID of the checklist on the specified card, containing the item to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update card closed status by id **Slug:** `TRELLO_UPDATE_CARDS_CLOSED_BY_ID_CARD` Updates the 'closed' status of an existing Trello card. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | Desired 'closed' state: 'true' to close (archive) the card, 'false' to re-open (unarchive) and return it to the board. | | `idCard` | string | Yes | The ID or shortLink of the Trello card to be updated. The card ID is a 24-character hexadecimal string, while the shortLink is a shorter code found in the card's URL. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update card description **Slug:** `TRELLO_UPDATE_CARDS_DESC_BY_ID_CARD` Updates or clears the entire description of an existing Trello card; use an empty string for `value` to clear. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new description for the card (0-16384 characters). An empty string clears the card's current description. | | `idCard` | string | Yes | The ID or short link of the card whose description will be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update card due date **Slug:** `TRELLO_UPDATE_CARDS_DUE_BY_ID_CARD` Updates the due date of a specific Trello card; the card identified by `idCard` must exist. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new due date for the card (e.g., 'YYYY-MM-DD', 'YYYY-MM-DDTHH:mm:ss.sssZ'), or `null` to remove the current due date. | | `idCard` | string | Yes | The ID or short link of the Trello card to update. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update card attachment cover **Slug:** `TRELLO_UPDATE_CARDS_ID_ATTACHMENT_COVER_BY_ID_CARD` Sets or removes the attachment cover for a Trello card. Provide a valid image attachment ID to set as cover, or an empty string ('') to remove the cover. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | ID of an existing image attachment on the card to set as the cover. To remove the cover, pass an empty string (''). The attachment must be an image type to be used as a cover. | | `idCard` | string | Yes | ID or shortLink of the Trello card. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Move card to board **Slug:** `TRELLO_UPDATE_CARDS_ID_BOARD_BY_ID_CARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The ID of the destination board to which the card will be moved. This board must exist and be accessible. | | `idCard` | string | Yes | The ID or shortLink of the card to be moved. This card must exist. | | `idList` | string | No | The ID of the list on the destination board where the card should be placed. If not provided, the card will be moved to the default list (usually the first one) on the target board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update card list ID **Slug:** `TRELLO_UPDATE_CARDS_ID_LIST_BY_ID_CARD` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The ID of the target list to move the card to. Must be a valid, existing list ID (24-character hex string). The target list must be on the same board as the card. | | `idCard` | string | Yes | The ID or short link of the card to be moved. Must be a valid, existing card ID. Card IDs can be short (e.g., `FY2OWrnc`) or long 24-character hex string (e.g., `571d07b591c8b68aeb4f6acc`). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Set card members **Slug:** `TRELLO_UPDATE_CARDS_ID_MEMBERS_BY_ID_CARD` Updates (sets/replaces) the list of members assigned to a Trello card. Pass a single member ID to assign one member, or pass an empty value to remove all members. Note: This replaces the entire member list, not appends to it. The card must exist and the member(s) must have board permissions. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The ID of the Trello member to assign to the card. This replaces any existing members. Pass an empty string to remove all members. | | `idCard` | string | Yes | The ID or shortlink of the Trello card whose members will be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update card labels **Slug:** `TRELLO_UPDATE_CARDS_LABELS_BY_ID_CARD` Replaces all labels on a Trello card with labels matching the specified colors. Use comma-separated color names (e.g., 'red,blue,green') or 'all' to add all board labels. This action removes existing labels and sets only the specified ones. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | Comma-separated list of label colors to set on the card, or 'all' to add all board labels. This REPLACES all existing labels on the card. Valid colors: 'yellow', 'purple', 'blue', 'red', 'green', 'orange', 'black', 'sky', 'pink', 'lime'. | | `idCard` | string | Yes | The ID or short link of the Trello card whose labels are to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update card name **Slug:** `TRELLO_UPDATE_CARDS_NAME_BY_ID_CARD` Updates the name of an existing Trello card, identified by its ID or shortLink; other card properties remain unchanged. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The new name for the card (required). Must be a non-empty string with a length from 1 to 16384 characters. | | `idCard` | string | Yes | The ID or shortLink of the Trello card whose name is to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update card position **Slug:** `TRELLO_UPDATE_CARDS_POS_BY_ID_CARD` Updates a Trello card's position within its list to 'top', 'bottom', or a specified 1-indexed positive integer. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | New position for the card: 'top', 'bottom', or a positive integer (1-indexed). | | `idCard` | string | Yes | ID or shortLink of the Trello card to move. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update card sticker attributes **Slug:** `TRELLO_UPDATE_CARDS_STICKERS_BY_ID_CARD_BY_ID_STICKER` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `top` | string | No | Vertical position (y-coordinate) in pixels, as a numeric string. | | `left` | string | No | Horizontal position (x-coordinate) in pixels, as a numeric string. | | `image` | string | No | New image for the sticker (URL or pre-defined identifier); length 0-16384. | | `idCard` | string | Yes | The ID or short link of the card containing the sticker. | | `rotate` | string | No | Rotation angle in degrees. Note: Trello's API may not fully support this; parameter might be ignored or cause an error. | | `zIndex` | string | No | Stacking order (depth), as an integer string (e.g., '1'). Higher values are on top. | | `idSticker` | string | Yes | The ID of the sticker to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update card subscribed status **Slug:** `TRELLO_UPDATE_CARDS_SUBSCRIBED_BY_ID_CARD` Updates the user's subscription status for a Trello card, if the card exists and is accessible. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The desired subscription status. Set to 'true' to subscribe or 'false' to unsubscribe. | | `idCard` | string | Yes | The ID or short link of the Trello card to update. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update a checklist item **Slug:** `TRELLO_UPDATE_CHECKLIST_ITEM_BY_IDS` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pos` | string | No | The new position for the check item within its checklist. Accepts 'top', 'bottom', or a positive number (float or integer). Higher numbers are further down the list. | | `name` | string | No | The new name for the check item. Must be a string with a length from 1 to 16384 characters. | | `state` | string | No | The new completion state of the check item. Valid values are 'complete', 'incomplete', 'true', or 'false'. 'true' is an alias for 'complete', and 'false' is an alias for 'incomplete'. | | `idCard` | string | Yes | The ID or short link of the card containing the checklist item. | | `idCheckItem` | string | Yes | The ID of the check item to be updated. | | `idChecklist` | string | No | The ID of the target checklist to move the check item to. If omitted, the item remains in its current checklist. | | `idChecklistCurrent` | string | Yes | The ID of the checklist that currently contains the check item to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update checklist **Slug:** `TRELLO_UPDATE_CHECKLISTS_BY_ID_CHECKLIST` Updates an existing Trello checklist, allowing modification of its name, position, associated card/board, or copying items from a source checklist. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pos` | string | No | The new position for the checklist on the card. Accepts 'top', 'bottom', or a string representing a positive number (e.g., '1', '1024', '1.5'). | | `name` | string | No | The new name for the checklist. Must be a string with a length between 0 and 16384 characters, inclusive. | | `idCard` | string | No | The ID of the Trello card to which the checklist should be moved or associated. | | `idBoard` | string | No | The ID of the Trello board to which the checklist should be moved or associated. | | `idChecklist` | string | Yes | The unique identifier of the Trello checklist to be updated. | | `idChecklistSource` | string | No | The ID of a source Trello checklist whose items should be copied into the checklist being updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update checklist field **Slug:** `TRELLO_UPDATE_CHECKLISTS_BY_ID_CHECKLIST_BY_FIELD` Tool to update a specific field on a Trello checklist. Use when you need to update the name or position of a checklist. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | ID of the checklist to update. | | `field` | string | Yes | Field to update on the checklist. Must be either 'name' or 'pos'. | | `value` | string | Yes | The value to update the field to. For 'name': a string of length 1 to 16384 characters. For 'pos': 'top', 'bottom', or a positive number. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Move checklist to card **Slug:** `TRELLO_UPDATE_CHECKLISTS_ID_CARD_BY_ID_CHECKLIST` Moves a Trello checklist to a new parent card; the checklist and the destination card must exist. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | ID of the destination card for the checklist. | | `idChecklist` | string | Yes | ID of the checklist to be moved. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update checklist name **Slug:** `TRELLO_UPDATE_CHECKLISTS_NAME_BY_ID_CHECKLIST` Updates the name of an existing Trello checklist. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new name to assign to the checklist. This name must be a string with a length between 1 and 16384 characters. | | `idChecklist` | string | Yes | The unique identifier of the checklist whose name is to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update checklist position by id **Slug:** `TRELLO_UPDATE_CHECKLISTS_POS_BY_ID_CHECKLIST` Updates the position of an existing checklist on a Trello card. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new position for the checklist. Valid values are 'top', 'bottom', or a positive number (float or integer). | | `idChecklist` | string | Yes | The unique identifier of the checklist to be repositioned. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update label attributes **Slug:** `TRELLO_UPDATE_LABELS_BY_ID_LABEL` Updates an existing Trello label's attributes (color, name, or associated board) by its ID; the label must exist. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | The new name for the label. Must be a string with a length from 0 to 16384 characters. If omitted, the name remains unchanged. | | `color` | string | No | The new color for the label. Provide a valid Trello label color name or 'null' to remove the color. If omitted, the color remains unchanged. | | `idBoard` | string | No | The ID of the board to which the label should be moved or associated. If omitted, the label's board association remains unchanged. | | `idLabel` | string | Yes | The ID of the label to update. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update label field **Slug:** `TRELLO_UPDATE_LABELS_BY_ID_LABEL_BY_FIELD` Updates a specific field (color or name) on a Trello label by its ID. Use when you need to update only one field without affecting others. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID of the label to update. | | `field` | string ("color" | "name") | Yes | The field on the label to update. Must be either 'color' or 'name'. | | `value` | string | Yes | The new value for the field. For 'color', use Trello color names (e.g., 'red', 'blue', 'green', 'yellow', 'orange', 'purple', 'pink', 'sky', 'lime', 'black') or null to remove color. For 'name', use any string value. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update label color **Slug:** `TRELLO_UPDATE_LABELS_COLOR_BY_ID_LABEL` Updates the color of an existing Trello label, or removes its color if 'null' is specified for the value. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new color for the label. Valid Trello label color names (e.g., 'green', 'yellow', 'red', 'blue', 'purple', 'orange', 'black', 'sky', 'pink', 'lime') or 'null' to remove the color. | | `idLabel` | string | Yes | The ID of the Trello label whose color is to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update label name **Slug:** `TRELLO_UPDATE_LABELS_NAME_BY_ID_LABEL` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new name for the label, with a length from 0 to 16384 characters. Pass an empty string to clear the label's name without deleting the label. | | `idLabel` | string | Yes | The unique identifier (24-character hex string) of the Trello label whose name is to be updated. You can obtain this ID by creating a label (TRELLO_ADD_LABELS) or listing labels on a board (TRELLO_GET_BOARDS_LABELS_BY_ID_BOARD). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update list attributes **Slug:** `TRELLO_UPDATE_LISTS_BY_ID_LIST` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pos` | string | No | New position for the list on the board (e.g., 'top', 'bottom', '1', '1024.5'). | | `name` | string | No | New name for the list (1-16384 characters). | | `closed` | string | No | Set to 'true' to archive the list, or 'false' to unarchive. | | `idList` | string | Yes | The unique identifier of the Trello list to be updated. This ID is a path parameter. | | `idBoard` | string | No | ID of the board to move the list to. | | `subscribed` | string | No | Set to 'true' to subscribe the current user, or 'false' to unsubscribe. | | `idListSource` | string | No | ID of a source list whose cards will be copied to this list. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update lists closed status **Slug:** `TRELLO_UPDATE_LISTS_CLOSED_BY_ID_LIST` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new closed status for the list. Set to 'true' to close (archive) the list, or 'false' to re-open it. | | `idList` | string | Yes | The ID of the Trello list to update. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Move list to board **Slug:** `TRELLO_UPDATE_LISTS_ID_BOARD_BY_ID_LIST` Moves an existing Trello list (identified by `idList`) to an existing destination board (board ID in `value`), optionally setting its new position (`pos`). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pos` | string | No | Position for the list on the destination board. Valid values: 'top' (first position), 'bottom' (last position), or a positive number for a specific position. If omitted, the list retains its original position value. | | `value` | string | Yes | The unique identifier (24-character hex string) of the destination Trello board where the list will be moved. | | `idList` | string | Yes | The unique identifier (24-character hex string) of the Trello list to move to another board. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update list name **Slug:** `TRELLO_UPDATE_LISTS_NAME_BY_ID_LIST` Updates the name of an existing Trello list, identified by its ID; this only changes the list's name, not its cards or position. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | New name for the list. Must be between 1 and 16384 characters. | | `idList` | string | Yes | ID of the list to rename. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update list position **Slug:** `TRELLO_UPDATE_LISTS_POS_BY_ID_LIST` Changes a Trello list's order on a board to 'top', 'bottom', or a specified numeric position, affecting only its position. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | New position for the list: 'top', 'bottom', or a positive number. | | `idList` | string | Yes | The ID of the Trello list whose position is to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update list subscription **Slug:** `TRELLO_UPDATE_LISTS_SUBSCRIBED_BY_ID_LIST` Updates the subscription status for a Trello list, allowing the user to subscribe or unsubscribe to control notifications. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | Required. The desired subscription state. Use 'true' to subscribe to the list or 'false' to unsubscribe. This controls whether the user receives notifications for this list. | | `idList` | string | Yes | The unique identifier of the Trello list whose subscription status is to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Upload member avatar **Slug:** `TRELLO_UPDATE_MEMBER_AVATAR` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `file` | string | No | Base64-encoded string of the new avatar image (e.g., PNG, JPEG). Although schema-optional, a valid image string is required for successful avatar update. | | `idMember` | string | Yes | The ID or username of the Trello member. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update member avatar source **Slug:** `TRELLO_UPDATE_MEMBERS_AVATAR_SOURCE_BY_ID_MEMBER` Updates the avatar source for a specified Trello member. The avatar source determines which image is displayed as the member's profile picture: Gravatar (based on email), a previously uploaded custom image, or the default initials avatar. Note: This endpoint requires write permissions for member profiles. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The avatar source to use for the member's profile image. 'gravatar' uses the Gravatar service based on the member's email. 'upload' displays a previously uploaded custom avatar (must upload first via separate endpoint). 'none' shows the default initials-based avatar. | | `idMember` | string | Yes | The ID or username of the Trello member whose avatar source is to be updated. Use 'me' to refer to the authenticated user. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update member bio **Slug:** `TRELLO_UPDATE_MEMBERS_BIO_BY_ID_MEMBER` Updates the bio/description of a specified Trello member. The bio is a short text that appears on the member's profile. Requires write permissions for the member's account. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new bio content for the member. This can be an empty string or a string with a maximum length of 16,384 characters. | | `idMember` | string | Yes | The ID or username of the Trello member whose bio is to be updated. Use 'me' to refer to the authenticated user. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Member Board Background **Slug:** `TRELLO_UPDATE_MEMBERS_BOARD_BACKGROUNDS_BY_ID_MEMBER_BY_ID_B` Update Member Board Background #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `file` | string | No | Base64-encoded image data to replace the board background image. Only applicable for custom backgrounds. This parameter is rarely needed since most updates use brightness and tile properties. | | `tile` | string | No | Determines if the board background image should be tiled. Set to 'true' to tile the image, or 'false' to display it normally. | | `idMember` | string | Yes | The ID or username of the Trello member whose board background is being updated. Use 'me' for the authenticated user. | | `brightness` | string | No | Adjusts the brightness of the board background. Valid values are 'dark', 'light', or 'unknown'. | | `idBoardBackground` | string | Yes | The ID of the existing board background to be updated. This identifier specifies which of the member's board backgrounds will be modified. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Member Board Star **Slug:** `TRELLO_UPDATE_MEMBERS_BOARD_STARS_BY_ID_MEMBER_BY_ID_BOARD_S` Update Member Board Star #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pos` | string | No | New position for the board star ('top', 'bottom', or a positive number string like '1' or '1024.5'). 'top' is first, 'bottom' is last. | | `idBoard` | string | No | ID of the Trello board this star should point to; if provided, updates the star's reference. | | `idMember` | string | Yes | ID or username of the Trello member. | | `idBoardStar` | string | Yes | Unique ID of the board star to update (not the board ID it points to). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update member by ID **Slug:** `TRELLO_UPDATE_MEMBERS_BY_ID_MEMBER` Updates an existing Trello member's profile information, preferences, or username. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `bio` | string | No | Biography (0-16384 characters). | | `fullName` | string | No | Full name (at least 1 character; no leading/trailing spaces). | | `idMember` | string | Yes | The ID or username of the Trello member to update. | | `initials` | string | No | Initials (1-4 characters; no leading/trailing spaces). | | `username` | string | No | Desired username (at least 3 characters; lowercase letters, underscores, numbers only; must be unique). | | `avatarSource` | string | No | Source for the member's avatar. Valid values: 'gravatar', 'none', 'upload'. | | `prefs__locale` | string | No | Preferred locale (0-255 characters). | | `prefs__colorBlind` | string | No | Toggle color blind mode. Valid values: 'true', 'false'. | | `prefs__minutesBetweenSummaries` | string | No | Time between email summaries. Valid values: '-1' (disabled), '1' (every minute), '60' (every hour). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update member's custom board background **Slug:** `TRELLO_UPDATE_MEMBERS_CUSTOM_BOARD_BACKGROUNDS_BY_ID_MEMBER_` Update member's custom board background #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `file` | string | No | The new image file (URL or path) for the background. | | `tile` | string | No | Whether the background image should be tiled ('true' or 'false'). | | `idMember` | string | Yes | The ID or username of the Trello member. Use 'me' for the authenticated user. | | `brightness` | string | No | Sets the brightness for the background ('dark', 'light', or 'unknown'). | | `idBoardBackground` | string | Yes | The ID of the specific custom board background to update. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update member full name by id **Slug:** `TRELLO_UPDATE_MEMBERS_FULL_NAME_BY_ID_MEMBER` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new full name for the member. Must be a string with a length of at least 1 and cannot begin or end with a space. | | `idMember` | string | Yes | The ID or username of the Trello member whose full name is to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update member initials **Slug:** `TRELLO_UPDATE_MEMBERS_INITIALS_BY_ID_MEMBER` Updates the initials for a specified Trello member, identified by their ID or username. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | New initials (1-4 characters, no leading/trailing spaces). If omitted or an empty string is provided, Trello may clear the member's current initials. | | `idMember` | string | Yes | ID or username of the Trello member. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update member color blind preference **Slug:** `TRELLO_UPDATE_MEMBERS_PREFS_COLOR_BLIND_BY_ID_MEMBER` Updates a Trello member's color blind friendly mode preference. When enabled, labels display patterns in addition to colors to help users who have difficulty distinguishing colors. This setting only affects the authenticated member's view and does not change how other members see the board. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The desired state for the color blind preference. Must be 'true' to enable color blind friendly mode (adds patterns to labels), or 'false' to disable it. | | `idMember` | string | No | The ID or username of the Trello member whose color blind preference will be updated. Use 'me' to update the authenticated user's preference. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update member locale preference **Slug:** `TRELLO_UPDATE_MEMBERS_PREFS_LOCALE_BY_ID_MEMBER` Updates a Trello member's locale preference to change how dates, times, and numbers are displayed in the Trello UI. Requires 'account' scope in the API token. Use 'me' as idMember to update the authenticated user's locale. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The locale code to set for the member (e.g., 'en-US', 'fr-FR'). Must be a valid IETF language tag. This affects how dates, times, and numbers are displayed in the Trello UI for this member. | | `idMember` | string | Yes | The ID or username of the Trello member whose locale preference will be updated. Use 'me' to refer to the authenticated user. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Member Summary Interval **Slug:** `TRELLO_UPDATE_MEMBERS_PREFS_SUMMARY_INTERVAL_BY_ID_MEMBER` Updates a Trello member's preference for the frequency of email summary notifications; this setting affects only summary notifications. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The interval in minutes between email summary notifications. Use '-1' to disable summaries entirely, '1' for notifications every minute, or '60' for hourly summaries. Common values: -1 (disabled), 1 (every minute), 60 (hourly). | | `idMember` | string | No | The ID or username of the Trello member whose summary notification interval will be updated. Use 'me' to update the authenticated user's preference. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update member saved search **Slug:** `TRELLO_UPDATE_MEMBERS_SAVED_SEARCHES_BY_ID_MEMBER_BY_ID_SAVE` Update member saved search #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pos` | string | No | The new position for the saved search. Valid values are 'top', 'bottom', or a positive numeric string (e.g., '1', '2'). | | `name` | string | No | The new name for the saved search. Must be a non-empty string containing at least one non-space character. | | `query` | string | No | The new search query string. Must be a string with a length between 1 and 16384 characters, inclusive. | | `idMember` | string | Yes | The ID or username of the Trello member. Use 'me' to refer to the authenticated user. | | `idSavedSearch` | string | Yes | The ID of the saved search to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update member saved search name **Slug:** `TRELLO_UPDATE_MEMBERS_SAVED_SEARCHES_NAME_BY_ID_MEMBER_BY_ID` Update member saved search name #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The new name to be assigned to the saved search. Must be a non-empty string with at least one non-space character. | | `idMember` | string | Yes | The ID or username of the Trello member whose saved search is being updated. Use 'me' to refer to the authenticated user. | | `idSavedSearch` | string | Yes | The ID of the saved search to be renamed. This is a 24-character hexadecimal string that can be obtained from the 'get_members_saved_searches_by_id_member' action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update member saved search position **Slug:** `TRELLO_UPDATE_MEMBERS_SAVED_SEARCHES_POS_BY_ID_MEMBER_BY_ID_` Update member saved search position #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The new position for the saved search. Accepts 'top' to move to first position, 'bottom' to move to last position, or a positive integer (as a string) representing the desired numeric position. | | `idMember` | string | Yes | The ID or username of the Trello member. Use 'me' to refer to the authenticated user. | | `idSavedSearch` | string | Yes | The 24-character hexadecimal ID of the saved search to be repositioned. Obtain this ID from the get_members_saved_searches_by_id_member action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update member saved search query **Slug:** `TRELLO_UPDATE_MEMBERS_SAVED_SEARCHES_QUERY_BY_ID_MEMBER_BY_I` Update member saved search query #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The new query string for the saved search, defining the search criteria using Trello's search syntax. Must be 1 to 16384 characters. Supports operators like is:open, label:, due:, board:, list:, @member, etc. | | `idMember` | string | Yes | The ID or username of the Trello member whose saved search will be updated. Use 'me' for the authenticated user, or provide a 24-character hex member ID or username. | | `idSavedSearch` | string | Yes | The unique 24-character hexadecimal identifier of the saved search to update. Obtain this ID from the GET /members/{idMember}/savedSearches endpoint. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update member username **Slug:** `TRELLO_UPDATE_MEMBERS_USERNAME_BY_ID_MEMBER` Updates the username for an existing Trello member, identified by their ID or current username. IMPORTANT: This endpoint requires an authentication token (web session), not an API consent token. Third-party applications using API tokens cannot update member profile fields (username, fullName, initials, locale) - this is a Trello security restriction to ensure only members can modify their own profile data directly. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The new username for the member. Must be at least 3 characters long, unique across all Trello users, and contain only lowercase letters, numbers, and underscores. | | `idMember` | string | Yes | The ID or current username of the Trello member whose username is to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update notification status by id **Slug:** `TRELLO_UPDATE_NOTIFICATIONS_BY_ID_NOTIFICATION` Updates only the 'unread' status of a specific Trello notification. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `unread` | string | No | A string indicating the desired unread status. Set to 'true' to mark the notification as unread, or 'false' to mark it as read. | | `idNotification` | string | Yes | The unique identifier (ID) of the Trello notification to update. This is a 24-character hexadecimal string. You can obtain notification IDs by using the 'get_members_notifications_by_id_member' action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update notification unread status **Slug:** `TRELLO_UPDATE_NOTIFICATIONS_UNREAD_BY_ID_NOTIFICATION` Updates the unread status of a specific Trello notification. Use this action to mark notifications as read (value='false') or unread (value='true'). The notification must belong to the authenticated user. To get notification IDs, use the 'get_members_notifications_by_id_member' action first. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new unread status for the notification. Set to 'true' to mark the notification as unread, or 'false' to mark it as read. If not specified, the notification will be marked as read (unread=false). | | `idNotification` | string | Yes | The unique identifier (ID) of the Trello notification to update. This is a 24-character hexadecimal string. You can obtain notification IDs by using the 'get_members_notifications_by_id_member' action with idMember='me'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add organization logo **Slug:** `TRELLO_UPDATE_ORGANIZATION_LOGO` Sets or updates the logo for a Trello organization; the provided image file must adhere to Trello's format and size restrictions. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `file` | object | Yes | The logo image file to upload. Supported formats: PNG, JPEG, GIF. Must be a valid image file. | | `idOrg` | string | Yes | ID or unique name of the Trello organization. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update organization attributes **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_BY_ID_ORG` Updates various attributes of an existing Trello organization, identified by `idOrg`. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `desc` | string | No | New description for the organization (0-16384 characters). | | `name` | string | No | New name for the organization (0-16384 characters); typically lowercase, without spaces. | | `idOrg` | string | Yes | The ID or name of the organization to update. | | `website` | string | No | The organization's website URL. Must start with 'http://' or 'https://'. Use the literal string 'null' or an empty string to remove the website. | | `displayName` | string | No | New display name for the organization (length of at least 1, cannot begin or end with a space). | | `prefs__permissionLevel` | string | No | Sets the default permission level for new boards created in the organization. Valid values: 'private' or 'public'. | | `prefs__associatedDomain` | string | No | The Google Workspace domain to associate with the organization (e.g., 'example.com'). Clears the domain if an empty string is provided. | | `prefs__googleAppsVersion` | string | No | The version of Google Workspace integration. Valid values are '1' or '2'. | | `prefs__orgInviteRestrict` | string | No | Restricts organization membership invitations to email addresses from specified domains. Use a comma-separated list of domains (e.g., 'example.com,*.example.org'). An empty string removes restrictions. | | `prefs__externalMembersDisabled` | string | No | Set to 'true' to prevent external members (guests) from being added to boards within the organization. Set to 'false' to allow external members. | | `prefs__boardVisibilityRestrict__org` | string | No | Controls who can create organization-visible boards. Valid values: 'admin' (only admins), 'org' (any organization member), 'none' (disabled). | | `prefs__boardVisibilityRestrict__public` | string | No | Controls who can create public boards. Valid values: 'admin' (only admins), 'org' (any organization member), 'none' (disabled). | | `prefs__boardVisibilityRestrict__private` | string | No | Controls who can create private boards. Valid values: 'admin' (only admins), 'org' (any organization member), 'none' (disabled). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update organization description **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_DESC_BY_ID_ORG` Updates or clears the description for an existing Trello organization, identified by its ID or name, to a new string up to 16384 characters. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or name of the organization whose description is to be updated. This can be the organization's unique 24-character hexadecimal ID or its registered name. | | `value` | string | No | The new description for the organization. Must be a string with a length between 0 and 16384 characters. An empty string can be used to clear the existing description. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update organization display name **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_DISPLAY_NAME_BY_ID_ORG` Updates the display name of a Trello organization, identifiable by its current ID or name (`idOrg`), to the new `value`; other attributes remain unaffected. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or current name of the Trello organization to update. | | `value` | string | Yes | The new display name for the organization. Required. Must be at least 1 character and cannot begin or end with a space. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update an organization member **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_MEMBERS_BY_ID_ORG` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | string | No | Membership type determining the member's permissions within the organization; required by Trello API. | | `email` | string | No | Member's email address; used to identify an existing member or invite/add a new one. Required by the Trello API. | | `idOrg` | string | Yes | ID or name of the Trello organization (Workspace). | | `fullName` | string | No | Member's full name. Used when inviting a new member; required if `email` isn't linked to an existing Trello account. Must be >=1 character and not start/end with a space. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update organization member **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_MEMBERS_BY_ID_ORG_BY_ID_MEMBER` Updates a member's role/type (admin, normal, or observer) in a Trello organization. Note: This operation requires a premium Trello workspace - free workspaces cannot change memberships. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | string | Yes | The new membership type/role for the member in this organization. Determines permissions: 'admin' has full control, 'normal' is a standard member, 'observer' has read-only access. Note: Requires a premium workspace to change membership types. | | `idOrg` | string | Yes | The ID or name of the Trello organization (workspace). Can be the 24-character hex ID or the organization's short name. | | `idMember` | string | Yes | The 24-character hex ID of the member whose role in the organization should be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update org member deactivation status **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_MEMBERS_DEACTIVATION_BY_ID_ORG_B` Update org member deactivation status #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or name of the Trello organization (workspace). Example: '5a7e5c9e4a5a8c0f2a7b6c3d' or 'myworkspace'. | | `value` | string | Yes | Required. Set to 'true' to deactivate the member (suspend their access temporarily) or 'false' to reactivate them. | | `idMember` | string | Yes | The ID of the member whose deactivation status is to be updated. Note: You cannot deactivate yourself. Example: '5a7e5c9e4a5a8c0f2a7b6c3e'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update org membership **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_MEMBERSHIPS_BY_ID_ORG_BY_ID_MEMB` Update org membership #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | string | No | The new type for the membership. Valid values are 'admin', 'normal', or 'observer'. | | `idOrg` | string | Yes | The ID or name of the Trello organization. | | `idMembership` | string | Yes | The ID of the specific membership to be updated. | | `member_fields` | string | No | Member fields to return in the response. Use 'all' or a comma-separated list: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url, username. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update organization name by id **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_NAME_BY_ID_ORG` 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 identifier. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or current name of the Trello organization whose name is to be updated. | | `value` | string | Yes | The new name for the organization. It must be unique, at least 3 characters long, and contain only lowercase letters, underscores, and numbers. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update an organization's associated domain preferences **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_PREFS_ASSOCIATED_DOMAIN_BY_ID_OR` Update an organization's associated domain preferences #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or name of the organization to update. This organization must exist. | | `value` | string | No | The Google Workspace domain to link to this organization (e.g., 'example.com'). If an empty string is provided, the existing associated domain will be removed. The domain should be a valid, existing Google Workspace domain. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update organization board visibility preference **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_PREFS_BOARD_VISIBILITY_BY_ID_ORG` Updates the preference controlling who can set board visibility to 'organization-visible' within an existing Trello organization. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or unique name of the Trello organization for which to update the board visibility restriction. | | `value` | string | No | Specifies the permission level for setting a board's visibility to 'organization-visible'. Allowed values are: * `admin`: Only organization administrators can set boards to 'organization-visible'. * `none`: No specific restriction; board members with appropriate permissions can set its visibility to 'organization-visible'. * `org`: Any member of the organization can set boards to 'organization-visible'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update an organization's external members access **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_PREFS_EXTERNAL_MEMBERS_ACCESS_BY` Update an organization's external members access #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or unique name of the Trello organization to update. | | `value` | string | No | Boolean value to set the 'externalMembersDisabled' preference. 'true' disables adding external members, 'false' enables it. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update organization permission level **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_PREFS_PERMISSION_LEVEL_BY_ID_ORG` Updates a Trello organization's `permissionLevel` preference, determining if it's members-only or link-accessible, and affecting new board default visibility. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or unique name of the Trello organization (Workspace). For example, 'trelloorg123' or 'MyTrelloOrganizationName'. | | `value` | string | No | The new permission level for the organization. Must be either 'private' or 'public'. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update organization private board visibility restriction **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_PREFS_PRIVATE_BOARD_VISIBILITY_B` Update organization private board visibility restriction #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The unique ID (e.g., '605c72ef2f849a001c2f3a4b') or short name (e.g., 'myorganization') of the Trello organization whose private board visibility restrictions are to be updated. | | `value` | string | Yes | Restriction level determining who can create or change visibility of private boards within the organization. Valid values: 'admin' (only admins can create private boards), 'org' (any organization member can create private boards), 'none' (private boards are disabled). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update organization public board visibility **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_PREFS_PUBLIC_BOARD_VISIBILITY_BY` Update organization public board visibility #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or name of the Trello organization. | | `value` | string | No | Specifies the restriction level for setting board visibility to public. Valid values are 'admin' (only administrators can set boards to public), 'org' (any member of the organization can set boards to public), or 'none' (public boards are disabled for the organization). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update organization website **Slug:** `TRELLO_UPDATE_ORGANIZATIONS_WEBSITE_BY_ID_ORG` Updates the website URL for a specified Trello organization. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or name of the organization to update. | | `value` | string | No | The new website URL for the organization. Must start with 'http://' or 'https://'. Provide 'null' or an empty string to remove the website. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update organization Google Apps version **Slug:** `TRELLO_UPDATE_ORG_GOOGLE_APPS_VERSION` Updates the Google Apps integration version preference for a specified Trello organization, to manage compatibility or features related to Google Workspace services. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The ID or name of the Trello organization to update. | | `value` | string | No | The Google Apps version (typically '1' or '2') to set for the organization, representing different integration versions or configurations. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update organization invite restriction **Slug:** `TRELLO_UPDATE_ORG_INVITE_RESTRICTIONS` Adds an email domain restriction to a Trello organization's invitation policy. Members can only be invited if their email matches the specified domain. This is an Enterprise-only feature requiring admin privileges on the organization. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `idOrg` | string | Yes | The unique identifier (ID) or name of the Trello organization (workspace). Note: This endpoint requires Trello Enterprise with admin privileges. | | `value` | string | Yes | The email domain restriction to add for organization invitations. Must be a valid email domain (e.g., 'example.com') that members must have to be invited to the organization. Requires Trello Enterprise. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update session by id **Slug:** `TRELLO_UPDATE_SESSIONS_BY_ID_SESSION` Updates a Trello user session's viewed board ID or status; call when user activity or board focus changes. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `status` | string | No | The new status of the session. Valid values are 'active', 'disconnected', or 'idle'. | | `idBoard` | string | No | The ID of the Trello board the user is currently viewing. | | `idSession` | string | Yes | The unique identifier of the session to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update session status by ID **Slug:** `TRELLO_UPDATE_SESSIONS_STATUS_BY_ID_SESSION` Updates the status of an existing Trello session. IMPORTANT: This endpoint is part of Trello's internal/deprecated session API. WebSocket connections via API key+token were deprecated on November 15, 2024. This endpoint may not be accessible via standard API authentication. Use this to update a session's activity status (active/idle/disconnected) for real-time presence tracking in Trello boards. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new status to set for the session. Accepted values: 'active' (user is actively using Trello), 'idle' (user is away/inactive), 'disconnected' (session ended). | | `idSession` | string | Yes | The unique identifier of the Trello session whose status is to be updated. Session IDs are obtained when creating a session via POST /sessions. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update webhook active status **Slug:** `TRELLO_UPDATE_WEBHOOKS_ACTIVE_BY_ID_WEBHOOK` Updates the active status of an existing Trello webhook. Set `value` to 'true' to activate the webhook (enable notifications) or 'false' to deactivate it (pause notifications). The webhook's other properties (callbackURL, idModel, description) remain unchanged. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The desired active state for the webhook. Must be 'true' to activate or 'false' to deactivate. | | `idWebhook` | string | Yes | The unique 24-character hexadecimal identifier of the webhook to update. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update webhooks **Slug:** `TRELLO_UPDATE_WEBHOOKS_BY_ID_WEBHOOK` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `active` | string | No | Indicates if the webhook is active (true) or inactive (false). | | `idModel` | string | No | ID of the Trello model (e.g., board, card, list) the webhook should monitor. | | `idWebhook` | string | Yes | The ID of the webhook to update. | | `callbackURL` | string | No | New valid URL for POST requests; Trello verifies with a HEAD request before updating. | | `description` | string | No | New description for the webhook (0-16384 characters). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update webhook callback url **Slug:** `TRELLO_UPDATE_WEBHOOKS_CALLBACK_URL_BY_ID_WEBHOOK` Updates the callback URL for a specific Trello webhook; other webhook attributes remain unchanged. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | A valid URL that Trello will send a HEAD request to verify. This URL will receive webhook notifications. | | `idWebhook` | string | Yes | The ID of the webhook to update. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update webhook description **Slug:** `TRELLO_UPDATE_WEBHOOKS_DESCRIPTION_BY_ID_WEBHOOK` Updates the description of an existing Trello webhook; an empty string for the new description removes the current one. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | No | The new description for the webhook. Must be a string with a length between 0 and 16384 characters. An empty string will remove the existing description. | | `idWebhook` | string | Yes | The unique identifier of the webhook whose description is to be updated. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update webhook idModel **Slug:** `TRELLO_UPDATE_WEBHOOKS_ID_MODEL_BY_ID_WEBHOOK` 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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The new ID of the Trello model (e.g., board, list, or card) that the webhook should monitor. This ID will replace the webhook's current `idModel`. Must be a valid 24-character Trello object ID. | | `idWebhook` | string | Yes | The unique identifier of the webhook whose monitored model is to be updated. This ID is part of the request URL path. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ## Triggers ### Card Archived Trigger **Slug:** `TRELLO_ARCHIVED_CARD_TRIGGER` **Type:** webhook Triggered when a card is archived in the specified board #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `board_id` | string | Yes | ID of the board to monitor | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `archived_at` | string | No | When the card was archived | | `archived_by` | string | No | Username who archived the card | | `board_id` | string | No | ID of the board | | `board_name` | string | No | Name of the board | | `card_id` | string | Yes | ID of the archived card | | `card_name` | string | Yes | Name/title of the card | | `description` | string | No | Card description if any | ### New Activity Trigger **Slug:** `TRELLO_NEW_ACTIVITY_TRIGGER` **Type:** webhook Triggered when there is activity in Trello. #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `action_id` | string | Yes | ID of the activity | | `action_type` | string | Yes | Type of activity | | `board_id` | string | No | ID of the board if applicable | | `board_name` | string | No | Name of the board if applicable | | `card_id` | string | No | ID of the card if applicable | | `card_name` | string | No | Name of the card if applicable | | `created_at` | string | No | When the activity occurred | | `member_id` | string | No | ID of the member who performed the action | | `member_name` | string | No | Name of the member who performed the action | ### New Board Trigger **Slug:** `TRELLO_NEW_BOARD_TRIGGER` **Type:** webhook Triggered when a board is created in the specified workspace #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `workspace_id` | string | Yes | ID of the workspace to monitor | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `board_id` | string | Yes | ID of the new board | | `board_name` | string | Yes | Name of the board | | `created_at` | string | No | When the board was created | | `created_by` | string | No | Username who created the board | | `description` | string | No | Board description if any | ### New Card Trigger **Slug:** `TRELLO_NEW_CARD_TRIGGER` **Type:** webhook Triggered when a card is created in the specified board #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `board_id` | string | Yes | ID of the board to monitor | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `board_id` | string | No | ID of the board | | `board_name` | string | No | Name of the board | | `card_id` | string | Yes | ID of the new card | | `card_name` | string | Yes | Name/title of the card | | `created_at` | string | No | When the card was created | | `created_by` | string | No | Username who created the card | | `description` | string | No | Card description if any | ### Card Updated Trigger **Slug:** `TRELLO_UPDATED_CARD_TRIGGER` **Type:** webhook Triggered when a specific card is updated #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `card_id` | string | Yes | ID of the specific card to monitor | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `board_id` | string | No | ID of the board | | `board_name` | string | No | Name of the board | | `card_id` | string | Yes | ID of the updated card | | `card_name` | string | Yes | Name/title of the card | | `description` | string | No | Current card description | | `new_data` | object | No | New values of updated fields | | `old_data` | object | No | Previous values of updated fields | | `updated_at` | string | No | When the card was updated | | `updated_by` | string | No | Username who updated the card |