Trello

1. Overview

Trello is a popular project management and collaboration tool based on the Kanban method. It helps teams and individuals organize tasks, track progress, and collaborate efficiently through the visual form of boards, lists, and cards.

Through GoInsight's Trello node, you can seamlessly integrate powerful project management capabilities into your automation workflows. You can manage the full lifecycle of core resources in Trello, including:

• Board Management: Create, update, delete, and get detailed information about boards.
• List and Card Operations: Create, move, and manage lists on boards; create, update, delete, and query cards in lists.
• Member Collaboration: Add, remove, and invite members to join boards, enabling dynamic team management.
• Task Refinement: Add comments, attachments, labels, checklists, and checklist items to cards for detailed task tracking.
• Global Search: Search for boards, cards, and members in your Trello account.

2. Prerequisites

Before using this node, you need to have a valid Trello account. You may need administrator or specific permissions to create and manage API credentials.

3. Credentials

For a detailed guide on how to obtain and configure credentials, please refer to our official documentation: Credential Configuration Guide.

4. Supported Operations

Summary

This Trello node primarily operates on boards, lists, cards, members, and their related sub-resources (such as attachments, comments, labels, checklists, and search). The following table summarizes all supported operations:

Operation Details

Create a Board

Creates a new Trello board with the specified name and optional settings including description, organization, default labels, and default lists. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• BoardName (string): Human-readable name for the new board; this title appears in the Trello UI and in board pickers across the workspace.

Options:

• BoardDesc (string): Optional longer board description text; supports basic formatting and helps agents document the board purpose.
• IdOrganization (string): Optional organization ID to create the board under; omit for personal boards or when using the default workspace context.
• DefaultLabels (bool): When true, Trello pre-creates common label colors on the new board; set false if you will define labels yourself.
• DefaultLists (bool): When true, Trello adds default lists such as To Do; set false for an empty list layout you will configure manually.

Output:

• BoardCreated (bool): Indicates whether the board was successfully created.
• BoardData (object): Contains the complete board data including id, name, description, URL, preferences, and other board properties.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Delete Board

Deletes a Trello board permanently by board ID. This action cannot be undone and will remove all lists, cards, and board data associated with the board. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• BoardId (string): Identifier of the board to delete; this cannot be undone, so agents should confirm the correct board ID before deletion.

Output:

• Deleted (bool): Indicates whether the board was successfully deleted.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Get Board Data

Retrieves comprehensive data for a Trello board by board ID, including all lists, cards, members, labels, activities, and board settings. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• BoardId (string): The ID of the Trello board to retrieve data from.

Output:

• BoardData (object): An object containing comprehensive board data including id, name, description, lists, cards, members, labels, activities, and all board settings.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Update a Board

PATCH-style: only set fields are sent. Core: BoardId, Name, Description, Closed, PermissionLevel, Voting, Comments. Advanced: pack selfJoin, cardCovers, hideVotes, background, cardAging, calendarFeedEnabled into AdditionalPrefs as an object. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• BoardId (string): Board id (often 24-char hex from Get Board Data / Search Trello). The short token in https://trello.com/b/SHORT/title is not the same as the REST id — always use the API id. Example: "5abbe4b7ddc1b351ef961400"

Options:

• Name (string): Optional new board title; leave unchanged by omitting updates if your workflow only adjusts description or visual settings.
• Description (string): Optional new board description (markdown/plain). Example: "Team charter: goals, links to docs, Slack #channel …".
• Closed (bool): Close (archive) the board. Omit to leave unchanged.
• PermissionLevel (string): private: invite-only, good for sensitive work; org: visible to workspace/org members; public: anyone with the link. Omit to leave unchanged.
• Voting (string): Who may vote: disabled | members | observers | org | public.
• Comments (string): Who may comment: same values as Voting. observers: collaborator role with limited write powers (see Trello help).
• AdditionalPrefs (object): Optional advanced prefs sent as Trello prefs/* query params (PUT /1/boards/{id}). Keys (use camelCase or snake_case): selfJoin (bool), cardCovers (bool), hideVotes (bool), background (string: color key or custom image id), cardAging ("regular" | "pirate"), calendarFeedEnabled (bool). Omit unused keys. Example: {"selfJoin": true, "background": "blue", "cardAging": "regular"}

Output:

• BoardData (object): Full board JSON from Trello after PUT. Top-level: id, name, desc, closed, url, shortUrl, labelNames, dateLastActivity. prefs (object) includes permissionLevel, voting, comments, background, cardCovers, selfJoin, hideVotes, cardAging, calendarFeedEnabled, etc.
• Updated (bool): Indicates whether the board was successfully updated.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Add Board Member

Adds a member to a board (admin / normal / observer). Invite emails are not sent by this API alone. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• BoardId (string): Board id (often 24-char hex). Use Get My Boards / Search Boards or board APIs for the REST id (browser short slug in /b/SHORT/ is not enough alone). Example: "5abbe4b7ddc1b351ef961414"
• MemberId (string): Username, email, or member id. Find ids via Get Board Members / Search Members. Example: johndoe

Options:

• MemberType (string): admin: full board control; normal: edit cards/lists; observer: read-only. Default: normal.

Output:

• MemberAdded (bool): Indicates whether the member was successfully added to the board.
• MemberData (object): Member object: id (string), fullName (string), username (string), type (string), avatarHash (string), avatarUrl (string), initials (string), confirmed (bool), memberType (string), …
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Get Board Members

Retrieves all members of a specific Trello board by board ID, including comprehensive member information such as user details, avatars, preferences, and permissions. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• BoardId (string): The ID of the Trello board to retrieve members from.

Output:

• MembersData (object-array): An array of all board members with comprehensive information including id, fullName, username, avatars, bio, status, permissions, and preferences.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Invite Member to Join a Board

Invites a member to join a Trello board by email address with specified permissions (normal, admin, or observer). Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• BoardId (string): The ID of the board to invite the member to.
• Email (string): Invitee email address that will receive the Trello board invitation link; must be deliverable and match the intended user.

Options:

• Type (string): Board membership role to grant after acceptance: normal member, admin, or observer; must match Trello-supported invite types.
• FullName (string): Full name of the member to be invited (optional).

Output:

• MemberInvited (bool): Indicates whether the member was successfully invited to the board.
• InvitationData (object): An object containing the invitation details including member ID, email, permission type, confirmation status, and board information.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Remove Board Member

Removes a member from a board immediately; they lose access until re-invited, and prior roles/permissions are not automatically restored. Requires board admin rights. Set Confirm=true to proceed. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Other writes/deletes may be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• BoardId (string): The Trello board id to remove the member from. Obtain via Get Board Data or Search Trello. Example: "5f8a1b2c3d4e5f6a7b8c9d0e"
• MemberId (string): Member id or username to remove. Obtain via Get Board Members or profile URL (e.g., trello.com/u/username). Example: "johndoe123" or "5f8a1b2c3d4e5f6a7b8c9d0e"

Options:

• Confirm (bool): Safety gate: must be true to perform removal and prevent accidental destructive calls.

Output:

• MemberRemoved (bool): Indicates whether the member was successfully removed from the board.
• RemovedMemberInfo (object): Member snapshot fetched before removal: id (string), username (string), fullName (string), avatarHash, avatarUrl, initials, memberType (e.g., normal|admin), boardId (string). If the pre-fetch fails, username/fullName may be "unknown".
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Archive or Unarchive a List

Archives or unarchives a Trello list by updating its closed status. Archive is reversible—unarchive anytime; lists are not deleted. Other write/delete operations may still be irreversible. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• ListId (string): The unique identifier of the Trello list to archive or unarchive. This is typically a 24-character hexadecimal string (e.g., 507f1f77bcf86cd799439011). Obtain list IDs via Get All Lists or Get Board Data. Example: "507f1f77bcf86cd799439011"

Options:

• Archive (bool): Set to true to hide the list (archive), or false to show it again (unarchive). Archived lists are not deleted and can be restored anytime.
• Fields (string): Optional comma-separated list of fields to return on the updated list (e.g., "id,name,closed,idBoard"). Use "all" (default) for the standard full list object from Trello.

Output:

• ListInfo (object): Updated list object. Common fields: id (string, 24-char hex), name (string), closed (boolean, archived), idBoard (string), pos (number, board position), subscribed (boolean), softLimit (number|null), type (string|null), datasource (object, metadata).
• Archived (bool): Indicates whether the list is currently archived (closed).
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Create a List

Creates a new list on a specified Trello board with a given name and optional position, allowing users to organize cards within structured lists on their boards. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• BoardId (string): The ID of the Trello board where the list will be created.
• ListName (string): Name of the new list column on the board; position it with list-order APIs if you need a specific lane arrangement.

Options:

• Position (string): Optional. The position of the list on the board. Can be 'top', 'bottom', or a numeric value.

Output:

• ListInfo (object): Contains the newly created list information including id, name, board ID, position, subscription status, and limits.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Get All Lists

Retrieves lists on a board. Limit (if set) is applied locally after download because the Trello lists endpoint has no native pagination. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• BoardId (string): The ID of the Trello board to retrieve lists from.

Options:

• Limit (number): Optional max number of lists returned after the API response is received (client-side slice; Trello has no list limit query param). Common values: 10, 50, 100. Omit or 0 = return all. Example: 50

Output:

• Lists (object-array): Array of list objects. Each item: id (string), name (string), closed (bool), idBoard (string), pos (number, sort order), subscribed (bool), softLimit (number|null), limits (object, quota metadata e.g. attachments).
• Pagination (object): Present on success: returned_count (length of Lists), total_count (lists on board before Limit), limit_applied (0 = no cap), is_truncated (true if Limit shortened the result).
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Get List Data

Gets list details with embedded cards; optional CardsLimit truncates ListData.cards locally (Trello returns full card set first). Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• ListId (string): The ID of the Trello list to retrieve data from.

Options:

• CardsLimit (number): Max cards to keep in ListData.cards after the full list payload is fetched (0 = no local truncation). Trello does not support server-side card limits on this endpoint.

Output:

• ListData (object): A dictionary containing comprehensive list data including id, name, position, cards, and associated board information.
• Pagination (object): Card truncation metadata: total_card_count, returned_card_count, cards_limit_applied, is_truncated.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Update a List

Updates a Trello list's properties including name, archive status, position, and subscription settings. Allows modification of list metadata and configuration options within a board. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• ListId (string): Identifier of the list column to rename or archive-related updates; always source ids from board list enumeration calls.

Options:

• Name (string): Optional new list title shown as the swimlane header; clarity here helps agents pick correct destination lists for new cards.
• Closed (string): Whether to archive the list: 'true' or 'false' (optional).
• Position (string): Position of the list: 'top', 'bottom', or numeric value (optional).
• Subscribed (string): Whether to subscribe to the list: 'true' or 'false' (optional).

Output:

• ListData (object): An object containing the updated list information including id, name, board ID, position, subscription status, and limits.
• Updated (bool): Indicates whether the list was successfully updated.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Create a Card

Creates a new card in a Trello list. Optional fields (pos, due, members, labels, dueComplete, etc.) can be omitted; only Name and IdList are required. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• Name (string): Primary card title visible on the list; choose a short actionable summary that agents and humans can scan quickly on the board.
• IdList (string): The list id where the card is created. Obtain via Get Lists on a Board (or board/list APIs) using your board id. Example: "5abbe4b7ddc1b351ef961414"

Options:

• Desc (string): Optional multi-line card description body; use it for acceptance criteria, links, or context beyond the title alone.
• Pos (string): Card position in the list. Use top, bottom, or a positive number (Trello uses fractional ordering; larger values appear lower). Leave empty to append at the bottom. Example: "top"
• Due (string): Optional due datetime (ISO 8601, UTC). Format YYYY-MM-DDTHH:MM:SSZ. Example: "2024-12-31T17:00:00Z". Leave empty when there is no deadline.
• IdMembers (string): Comma-separated member ids to assign (no spaces). Multiple ids: "id1,id2". Obtain via Get Board Members / member lookup. Leave empty for no assignees. Example: "5e8b3f4a1c2d3e4f5a6b7c8d,5f9c4e5b2d3e4f5a6b7c8d9e"
• IdLabels (string): Comma-separated label ids (no spaces). Obtain via Get Labels on a Board. Label ids differ from label names. Leave empty for no labels. Example: "5abbe4b7ddc1b351ef961417,5abbe4b7ddc1b351ef961418"
• Start (string): Optional start datetime (ISO 8601 UTC). Example: "2024-12-01T09:00:00Z". Leave empty if unused.
• DueComplete (bool): Whether the due date is marked complete when the card is created. Omit or leave empty for Trello default (false).

Output:

• CardInfo (object): Created card object. Core fields: id (string), name (string), desc (string), closed (bool), idList (string), idBoard (string), labels (array of label objects), members (array of member objects), due (string|null), start (string|null), dueComplete (bool), dateLastActivity (string), url (string), shortUrl (string), pos (number).
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Delete Card

Deletes one or more Trello cards by id (irreversible). Multiple ids: English comma or fullwidth comma; spaces around commas are tolerated. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CardId (string): One card id or multiple ids separated by English comma , (Unicode fullwidth ， is normalized). Optional spaces after commas are trimmed per id. Obtain ids from Get a Card, Get List Cards, Search Trello, or the card URL.

Output:

• AllDeleted (bool): Indicates whether all specified cards were successfully deleted.
• FailedItems (object-array): Per-card failures: each object has CardId (string), StatusCode (number, HTTP or 500 for transport), ErrorMessage (string).
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Upstream diagnostic HTTP code after all DELETE attempts finished: 200 if every delete returned HTTP 200; otherwise typically the first non-success status from a failed item (e.g. 404).
• StatusCode (number): Tool-level: -1 validation; 200 when HTTP round-trips completed—then use AllDeleted, ErrorMessage, and FailedItems for outcome; 500 only for network/session errors before finishing the loop.
• ErrorMessage (string): Empty on full success. Non-empty for validation errors, partial batch failure, or when every delete failed after upstream responses (see FailedItems).

Get a Card

Retrieves detailed information about a specific Trello card by its card ID. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CardId (string): Identifier of the card to fetch in full detail; copy this from list cards, search results, or recent create-card responses.

Output:

• CardInfo (object): An object containing detailed card information including id, name, description, status, board/list IDs, labels, members, due dates, and URLs.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Get List Cards

Lists cards in one Trello list with Limit (1–1000) and Filter (all, open, closed, or none). HasMore signals a full page; long lists need smaller limits or cursor-based follow-ups to avoid huge payloads. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• ListId (string): Trello list (column) ID, usually a 24-char hex string. Obtain from Get All Lists / Get Board Data (lists[].id) or search APIs — not the board id.

Options:

• Limit (number): Max cards to return in this call (Trello limit). Default 50, max 1000. If HasMore is true, the list may have more cards — lower this for agents with tight context, or combine with Trello before/since cursors in a future enhancement.
• Filter (string): Trello list cards filter: all (open+closed), open (unfinished default-style), closed (archived in list), none. Case-insensitive; invalid values return -1.

Output:

• Cards (object-array): Cards returned in this response. Typical keys per card: id, name, desc, closed, idList, idBoard, pos, due, dueComplete, labels[], members[], badges, url, ... (full fields=all payload).
• TotalCards (number): Count of cards in this response batch (equals len(Cards)), not guaranteed total in the list.
• HasMore (bool): True when the API returned exactly Limit cards — there may be additional cards; increase Limit (up to 1000) or use Trello cursor params (before/since) in follow-up requests.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Update a Card

PATCH-style: only fields you provide are updated; empty optional fields are left unchanged. Required: CardId plus at least one of Name, Description, Closed, IdList, Due, DueComplete, Start. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CardId (string): Card id to update. Obtain via Search Cards, Get Cards in List, or Get Card actions. You must also pass at least one other field to change (Name, Description, Closed, IdList, Due, DueComplete, or Start). Example: "5abbe4b7ddc1b351ef961414"

Options:

• Name (string): Optional replacement card title; supply only when renaming because empty strings may clear titles depending on API rules.
• Description (string): Optional replacement markdown-capable body; use it to refresh task details without recreating the entire card record.
• Closed (bool): Archive the card (true) or restore (false). Not deleted — archived cards can be unarchived. Omit to leave unchanged.
• IdList (string): Move card to this list (column) id. A board contains lists (e.g. To Do → Done); obtain ids via Get Lists on a Board. Example: "5acfe4b7ddc1b351ef961415"
• Due (string): Due datetime (ISO 8601 UTC). Format YYYY-MM-DDTHH:MM:SS.sssZ. Examples: "2024-12-31T23:59:59.000Z". Empty = omit field (unchanged).
• DueComplete (bool): Mark due checkbox complete (true) or incomplete (false). UI-only indicator; does not move lists. Omit to leave unchanged.
• Start (string): Start datetime (ISO 8601 UTC). Example: "2024-01-01T00:00:00.000Z". Omit if unused.

Output:

• Updated (bool): Indicates whether the card was successfully updated.
• CardInfo (object): Updated card: id (string), name, desc, closed (bool), idList, idBoard, labels (array), members (array), due, dueComplete (bool), start, dateLastActivity, url, shortUrl.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Create Card Attachment

Creates a new URL attachment for a Trello card with the specified name, URL, optional MIME type, and cover setting. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CardId (string): The ID of the card to add the attachment to.
• AttachmentName (string): Display name for the attachment in Trello; use a concise human-readable title describing the linked file or URL.
• AttachmentUrl (string): Public HTTPS URL of the resource to attach; Trello fetches this URL when the attachment is created successfully.

Options:

• MimeType (string): Optional MIME type string (for example application/pdf); leave empty unless you need to override Trello inference.
• SetCover (bool): When true, Trello should prefer this attachment as the card cover when the linked media type supports cover images.

Output:

• AttachmentCreated (bool): Indicates whether the attachment was successfully created.
• AttachmentData (object): A object containing the complete attachment data including id, name, URL, MIME type, size, creation date, and other attachment properties.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Delete Attachment

Deletes a specific attachment from a Trello card by providing the card ID and attachment ID, permanently removing the attachment from the card. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CardId (string): The ID of the Trello card that contains the attachment.
• AttachmentId (string): Trello attachment ID to delete permanently; obtain it from card attachment listing responses before calling delete.

Output:

• Deleted (bool): Indicates whether the attachment was successfully deleted.
• AttachmentId (string): The ID of the attachment that was deleted.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Get Card Attachments

Retrieves all attachments for a specific Trello card by card ID, including file details such as size, type, upload date, and download URLs. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CardId (string): The ID of the Trello card to retrieve attachments from.

Output:

• Attachments (object-array): A list of attachment objects with details like id, size, upload date, mime type, name, and download URL.
• AttachmentCount (number): The total number of attachments found for the card.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Create a Comment

Creates a new comment on a specified Trello card using the card ID and comment text. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CardId (string): The ID of the Trello card to add a comment to.
• CommentText (string): The content of the comment to be added to the card.

Output:

• CommentInfo (object): Contains detailed comment information including comment ID, creator details, comment text, creation date, and associated card information.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Delete a Comment

Deletes a specific comment from a Trello card using the comment ID (action ID). Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CommentId (string): The unique identifier of the comment (action ID) to be deleted.

Output:

• Deleted (bool): Indicates whether the comment was successfully deleted.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Get Card Comments

Fetches commentCard actions for one card with server-side paging (50 per page). Use Page and Pagination.has_more to walk all comments; upstream never returns a global total count. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CardId (string): Trello card ID (typically a 24-char hex string). Get it from the card URL (https://trello.com/c/{shortLink}/... short id vs API id), or from Get a Card, Get List Cards, Search Trello responses (id on the card object).

Options:

• Page (number): 1-based page index for Trello page query (API uses 0-based internally). Each page returns at most 50 comments. If Pagination.has_more is true, request Page+1 for the next batch. Trello does not return total comment count.

Output:

• Comments (object-array): This page of comment actions (commentCard). Each item includes string fields id, idMemberCreator, type, date; data.text (comment body); data.card.id / data.card.name; nested memberCreator with id, fullName, username, avatarHash.
• Pagination (object): Paging hints: page (1-based page you requested), per_page (50, Trello fixed max per page), has_more (true if this page is full — call again with Page+1 until false).
• CommentCount (number): Number of comments returned in this page (not total on the card).
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Update a Comment

Updates the text of an existing comment on a Trello card. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CommentId (string): Identifier of the existing card comment to edit in place; list comments on the card when the id is not already known.
• CommentText (string): Replacement plain text body for the comment; long threads should still be broken into readable paragraphs for agents.

Output:

• CommentInfo (object): An object containing the updated comment information including id, creator details, comment data with text, action type, date, member creator info, and associated card info.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Add Label to Card

Adds a label (color tag / category) to a card. Related: Get Labels on a Board, Remove Label from Card. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CardId (string): Card id to tag. Obtain via Search Cards, Get Cards in List, or card detail actions. Example: "5abbe4b7ddc1b351ef961414"
• LabelId (string): Label id to add (board-scoped). Obtain via Get Labels on a Board. Example: "5acfe4b7ddc1b351ef961415"

Output:

• LabelAdded (bool): True if the HTTP call succeeded (200). If the label was already on the card, Trello may still return success.
• CardLabelIDs (string-array): All label id strings on the card after the add (full set, not just the new one). Empty array if none. Each element is a string label id.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Remove Label from Card

Detaches a label from a card (does not delete the label definition on the board). You can re-attach later with Add Label to Card. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CardId (string): Card id (e.g. from Get List Cards, Get a Card, Search Trello).
• LabelId (string): Label id on the same board (e.g. from Get Labels on Board or card idLabels).

Output:

• LabelRemoved (bool): Indicates whether the label was successfully removed from the card.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Create Checklist on a Card

Creates a new checklist on a specified Trello card with the given name and optional position. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CardId (string): The ID of the Trello card where the checklist will be created.
• ChecklistName (string): Name of the new checklist container attached to the card; it groups multiple checkitems for task tracking.

Options:

• Pos (string): The position of the checklist (optional). Valid values include 'top', 'bottom', or a positive number.

Output:

• ChecklistInfo (object): An object containing detailed checklist information including id, name, card ID, board ID, position, and check items.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Delete a Checklist

Deletes one or more Trello checklists specified by their checklist IDs, this action cannot be undone. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• ChecklistId (string): A single Trello checklist ID or a comma-separated list of checklist IDs to be deleted.

Output:

• AllDeleted (bool): Indicates whether all specified checklists were successfully deleted.
• FailedItems (object-array): A list of failed deletion items with fields: ChecklistId, StatusCode, ErrorMessage.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Upstream diagnostic HTTP code after all DELETE attempts finished: 200 if every delete returned HTTP 200; otherwise typically the first non-success status from a failed item (e.g. 404).
• StatusCode (number): Tool-level: -1 validation; 200 when HTTP round-trips completed—then use AllDeleted, ErrorMessage, and FailedItems for outcome; 500 only for network/session errors before finishing the loop.
• ErrorMessage (string): Empty on full success. Non-empty for validation errors, partial batch failure, or when every delete failed (see FailedItems).

Get a Checklist

Retrieves detailed information about a specific Trello checklist by its checklist ID, including all check items and their status. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• ChecklistId (string): Identifier of the checklist to retrieve with all metadata; find it on the card object or checklist listing endpoints.

Output:

• ChecklistInfo (object): An object containing detailed checklist information including id, name, board/card IDs, position, and all check items with their status and details.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Get Checklists on a Card

Retrieves all checklists and their items from a specific Trello card by card ID. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CardId (string): The ID of the Trello card to retrieve checklists from.

Output:

• Checklists (object-array): An array of checklist objects, each including id, name, board/card IDs, position, and array of check items with their details.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Update a Checklist

Updates a Trello checklist's name and/or position. At least one update parameter (name or pos) must be provided. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• ChecklistId (string): Identifier of the checklist whose title you update; does not reorder items—use checklist position APIs for ordering.

Options:

• Name (string): Optional new checklist name string shown above its items on the card detail pane in Trello web and mobile clients.
• Pos (string): New position for the checklist. Can be a number string or 'top'/'bottom' (optional).

Output:

• ChecklistInfo (object): An object containing updated checklist information including id, name, board/card IDs, position, and all check items with their status and details.
• Updated (bool): Indicates whether the checklist was successfully updated.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Create Checkitem on Checklist

Creates a new checkitem on a specified Trello checklist with optional parameters for position, status, due date, reminder, and member assignment. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• ChecklistId (string): The ID of the Trello checklist where the checkitem will be created. Obtain via Get Checklists on a Card or Get a Checklist. Example: "5abbe4b7ddc1b351ef961414"
• CheckitemName (string): Title text of the checklist item to create; this is shown as one row inside the parent checklist on the card.

Options:

• Pos (string): Position in the checklist: "top" (first), "bottom" (last), or a number for absolute ordering (e.g., 16384; Trello often uses power-of-two spacing). Default placement when omitted is bottom. Example: "top" or "16384"
• Checked (bool): Initial completion state: true = checked/complete, false = unchecked/incomplete.
• Due (string): Optional due date-time in ISO 8601 (UTC), format YYYY-MM-DDTHH:MM:SS.sssZ. Example: "2024-12-31T23:59:59.000Z". Leave empty when not needed.
• DueReminder (number): Reminder offset in minutes before the due time. Examples: 60 (1 hour), 1440 (1 day), 10080 (1 week). Use 0 to omit a reminder.
• IdMember (string): Optional member id assigned to this checkitem. Obtain via Search Members or Get Board Members. Example: "5acfe4b7ddc1b351ef961415"

Output:

• CheckitemInfo (object): Checkitem payload: id (string), name (string), state (string: complete|incomplete), pos (number), due (string|null, ISO 8601), dueReminder (number|null, minutes), idMember (string|null), idChecklist (string).
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Delete Checkitem from Checklist

Deletes one or more checkitems from a Trello checklist by checklist ID and checkitem IDs, supporting comma-separated multiple IDs. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• ChecklistId (string): The ID of the Trello checklist that contains the checkitems to be deleted.
• CheckitemId (string): The ID(s) of the checkitem(s) to be deleted. Can be a single ID or comma-separated multiple IDs.

Output:

• AllDeleted (bool): Indicates whether all specified checkitems were successfully deleted.
• FailedItems (object-array): A list of failed deletion items with fields: CheckitemId, StatusCode, ErrorMessage.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Upstream diagnostic HTTP code after all DELETE attempts finished: 200 if every delete returned HTTP 200; otherwise typically the first non-success status from a failed item (e.g. 404).
• StatusCode (number): Tool-level: -1 validation; 200 when HTTP round-trips completed—then use AllDeleted, ErrorMessage, and FailedItems for outcome; 500 only for network/session errors before finishing the loop.
• ErrorMessage (string): Empty on full success. Non-empty for validation errors, partial batch failure, or when every delete failed (see FailedItems).

Get Checkitems on a Checklist

Retrieves all check items from a specific Trello checklist by its checklist ID, including their status, due dates, and assigned members. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• ChecklistId (string): The ID of the Trello checklist to retrieve check items from.

Output:

• CheckItems (object-array): A list containing all check items from the checklist with fields: id, name, state, pos, due, dueReminder, idMember, idChecklist.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Get Completed CheckList Items

Retrieves all completed check items from checklists on a specific Trello card, providing detailed information about finished tasks. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CardId (string): The ID of the Trello card to retrieve completed check items from.

Output:

• CompletedCheckItems (object-array): An array of completed check items with detailed information including id, name, state, position, checklist info, and member assignments.
• TotalCompleted (number): The total number of completed check items found on the card.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Update Checkitem on Checklist on Card

Updates a checkitem on a checklist within a Trello card by modifying its name, position, or completion state. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• CardId (string): Card id containing the checkitem. Obtain via Get List Cards, Search Trello, or card URLs (trello.com/c//...). Example: "67a1b2c3d4e5f6a7b8c9d0e1"
• CheckitemId (string): Existing checkitem id. From Get a Card / Get Checklists on a Card responses (checkItems arrays). Example: "67b2c3d4e5f6a7b8c9d0e1f2"

Options:

• CheckitemName (string): New name for the checkitem. Leave empty to keep unchanged.
• Position (string): New order: "top" (first), "bottom" (last), or a fractional number (e.g., 16384.5) between existing items. Leave empty to keep unchanged. Example: "top"
• State (string): New completion state of the checkitem. Accepts 'complete' or 'incomplete'. Leave empty to keep unchanged.
• Due (string): Due date-time in ISO 8601 UTC (YYYY-MM-DDTHH:MM:SS.sssZ). Example: "2025-12-31T23:59:59.000Z". Leave empty to keep unchanged.
• DueReminder (string): Reminder minutes before due: e.g., 60 (1 hour), 1440 (1 day), 10080 (1 week). Leave empty to keep unchanged.
• IdMember (string): Assignee member id from Get Board Members or Search Members. Leave empty to keep unchanged. Example: "67c3d4e5f6a7b8c9d0e1f2a3"

Output:

• CheckitemInfo (object): id (string), name (string), state (string: complete|incomplete), pos (number), due (string|null), dueReminder (number|null), idMember (string|null), idChecklist (string).
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Create a Label

Creates a new label on a specified Trello board with the given name and optional color. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• BoardId (string): The ID of the board where the label will be created.
• Name (string): Label text that appears on cards; combine with board color selection APIs when you need a visually distinct category marker.

Options:

• Color (string): The color of the label. Valid colors include: yellow, purple, blue, red, green, orange, black, sky, pink, lime, null.

Output:

• LabelInfo (object): Contains detailed label information including id, name, color, board ID, and usage count.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Delete a Label

Deletes a specific Trello label by its label ID. This action cannot be undone. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• LabelId (string): Identifier of the label to remove from its board; the label is deleted and unassigned from every card that used it.

Output:

• Deleted (bool): Indicates whether the label was successfully deleted.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Get a Label

Retrieves detailed information about a specific Trello label by its label ID. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• LabelId (string): Identifier of the label whose name and color you need; list labels on the board when you only know the board context.

Output:

• LabelInfo (object): A dictionary containing detailed label information including id, name, color, board ID, and usage count.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Get Labels on Board

Retrieves all labels from a specific Trello board by its board ID. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• BoardId (string): The ID of the Trello board to retrieve labels from.

Output:

• Labels (object-array): An array of label objects with fields: id, name, color, idBoard, and uses.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Update a Label

Updates a Trello label's name and/or color by its label ID. At least one of name or color must be provided. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• LabelId (string): Identifier of the label entry you are renaming or recoloring; board-wide labels share one id across every card.

Options:

• Name (string): Optional new visible label string; keep names distinct on the same board so automation can filter cards reliably later.
• Color (string): New color for the label (optional). Valid colors: yellow, purple, blue, red, green, orange, black, sky, pink, lime.

Output:

• LabelInfo (object): An object containing updated label information including id, name, color, board ID, and usage count.
• Updated (bool): Indicates whether the label was successfully updated.
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Search Members

Searches Trello accounts by name/username (Query). Scope with IdBoard (members likely on that board), IdOrganization, and/or OnlyOrgMembers. Not the same as listing board members only. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• Query (string): Substring of full name or username (e.g. Alex, jsmith). Provide enough characters to narrow collisions.

Options:

• Limit (number): Cap on returned members. Recommended: 10–50 for chat agents; up to 1000 for batch. Omit to let Trello apply its default cap for the endpoint.
• IdBoard (string): Optional 24-char board id to bias/rank results around that board (from Get Board Data / Search Trello). Leave empty for non-board-scoped search.
• IdOrganization (string): Optional organization id when searching inside an enterprise/org context (from org APIs). Required logically when OnlyOrgMembers=true for meaningful scoping.
• OnlyOrgMembers (bool): When true, narrow to org-linked accounts; pair with IdOrganization when possible.

Output:

• MembersData (object-array): Array of member objects. Typical keys: id, username, fullName, initials, avatarHash, avatarUrl, bio, confirmed, memberType, status, email (when permitted), activityBlocked, idBoards, idOrganizations, url.
• SearchMeta (object): Limit/pagination metadata: limit_requested (int passed to API, 0 if unset), returned_count (members in this response), limit_sent_to_upstream (whether limit was sent).
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

Search Trello

Searches boards, cards, members, and organizations. Trello search has no paging—CardLimit/BoardLimit are hard caps; use Pagination.is_truncated and narrow queries when needed. Don't use when: you need a different read granularity (pick a narrower get action), or you lack board/list/card ids—obtain ids via Get Board Data, Get All Lists, Get List Cards, or Search Trello first. Side effects: writes and deletes can be irreversible. Trello allows duplicate names; create actions do not deduplicate.

Input Parameters:

• Query (string): The search query, supporting Trello's advanced syntax (e.g., label:bug @me due:week).

Options:

• ModelTypes (string): Which Trello object kinds to search: all (default, everything), or one/more of boards (project boards), cards (tasks/items), members (users), organizations (teams/workspaces). Combine with commas, e.g., "boards,cards". Default: all.
• IdBoards (string): Optional comma-separated board ids to scope the search; leave empty for all boards you can access. IDs from Get Board Data or prior searches. Example: "5f3a2b1c4d5e6f7a8b9c0d1e,6a7b8c9d0e1f2a3b4c5d6e7f"
• CardLimit (number): Maximum cards returned in this request (1–1000). WARNING: Trello search has no paging—results beyond this cap cannot be fetched in a follow-up call; raise the cap or narrow the query/board scope if you hit the limit.
• BoardLimit (number): Maximum boards returned (1–1000). Same hard cap/truncation warning as CardLimit—no second page.

Output:

• SearchResults (object): Keys mirror Trello search JSON: cards (array of card objects: id, name, desc, idBoard, idList, url, shortUrl, ...), boards, members, organizations—only present when requested by ModelTypes.
• Pagination (object): Truncation metadata: cards_returned, boards_returned, members_returned, organizations_returned (numbers), cards_limit, boards_limit (requested caps), is_truncated (bool if a cap may have cut results), hint (string explaining no paging).
• Summary (string): One-sentence outcome for the agent (success path); empty when failed.
• Hint (string): Actionable next step when failed; empty on success.
• Retryable (bool): Whether retrying the same request may succeed.
• OriginalStatusCode (number): Original HTTP status code returned by the upstream API. Default 0 = request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success, including upstream errors — check OriginalStatusCode and ErrorMessage for details), 500 (network or server error), -1 (parameter validation error).
• ErrorMessage (string): Error description if the operation fails, empty string on success.

5. Example Usage

This section will guide you through creating a simple workflow to create a new card in a specific list on your Trello board.

Workflow Overview

Start -> Trello: Create a Card -> Answer

Step-by-Step Guide

1. Add Tool Node:
   • In the workflow canvas, click the "+" button to add a new node.
   • Select the "Tools" tab in the panel that appears.
   • Find and select Trello from the tools list.
   • In the list of operations supported by Trello, click to select Create a Card, which will add the corresponding node to the canvas.
2. Configure Node:
   • Click the newly added Create a Card node, and the configuration panel for this node will expand on the right.
   • Credential Configuration: At the top of the panel, find the credentials field. Click the dropdown menu and select your configured Trello credentials.
   • Parameter Entry: Fill in the input parameters for this operation in detail.
   • Name: Enter a title for your new card, for example "Complete Project Documentation".
   • IdList: Enter the ID of the list where you want to create the card. You can find this ID from the Trello list's URL. For example, in the URL https://trello.com/c/cardId/listId-card-name, listId is the value you need.
3. Run and Verify:
   • When all required parameters are filled in correctly, the error prompt in the upper right corner of the workflow canvas will disappear.
   • Click the "Test Run" button in the upper right corner of the canvas to execute the workflow.
   • After successful execution, you can click the log icon in the upper right corner to view the detailed input and output of the node. You should also be able to see the newly created card in the specified list in Trello.

Final Workflow Display

After completing the above steps, your entire workflow will be configured. After clicking "Test Run", a new Trello card will be successfully created in your specified list.

6. FAQs

Q: Why am I receiving a 401 Unauthorized or 403 Forbidden error?

A: This is usually related to your credential configuration. Please check the following:

• API Key and Token: Ensure that the Trello credentials (API Key and Token) you configured in GoInsight are correct and still valid.
• Permission Scope: Check whether the API token you generated has the permissions needed to perform the required operations (e.g., read and write permissions). You may need to regenerate a token with broader permissions in Trello.
• Board Permissions: Ensure that your Trello account is a member of the target board and has permissions to create or modify content.

Q: How do I get the ID for a board, list, or card?

A: You can easily find these IDs from Trello's URLs.

• Board ID: Open your board, the URL format is usually https://trello.com/b/[BoardId]/board-name.
• List and Card IDs: When you click on a card, the URL changes to https://trello.com/c/[CardId]/[ListId]-card-name. [CardId] is the card ID, and the following [ListId] is the list ID.

Q: Can I create multiple cards at once?

A: The Create a Card operation itself can only create one card at a time. However, you can design loop logic in a GoInsight workflow. For example, you can retrieve a list of items from a data source (such as an HTTP request or database query), then use a loop node to call the Create a Card node in each iteration to create a Trello card for each item in the list.

7. Official Documentation

For a deeper understanding of all Trello API features and parameters, please refer to the official documentation:

Trello Official API Documentation