trello Cards API
Operations for creating, retrieving, updating, and deleting cards, including managing card attachments, checklists, comments, labels, members, and stickers.
Operations 45
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Ask an LLM
“How do I add a new card to a list on my Trello board?”
“Can I set a due date, start date and members when I create a card?”
Tell an agent
Create a card called {name} on list {idList}.
Add a new card to list {idList} due {due} with description {desc}.
Ask an LLM
“How can I fetch everything about a single card, including its checklists and attachments?”
“What fields come back when I look up one card by its id?”
Tell an agent
Show me card {id} with its checklists and attachments.
Fetch the details of card {id}.
Ask an LLM
“How do I rename a card or change its description after it exists?”
“Can I move an existing card to another list or board by updating it?”
Tell an agent
Rename card {id} to {name}.
Move card {id} to list {idList}.
Ask an LLM
“How do I permanently delete a card rather than archive it?”
“Can a deleted card be restored afterwards?”
Tell an agent destructive · confirm first
Permanently delete card {id}.
Remove card {id} for good, no archive.
Ask an LLM
“Where can I see the activity history of a card?”
“Can I filter a card's activity to only comments?”
Tell an agent
Show the activity history for card {id}.
List only the {filter} actions on card {id}.
Ask an LLM
“How do I post a comment on a card through the API?”
“Can an integration leave notes on a card as comments?”
Tell an agent
Comment {text} on card {id}.
Post a new comment to card {id} saying {text}.
Ask an LLM
“Which files and links are attached to a card?”
“How do I get every attachment on one card?”
Tell an agent
List all attachments on card {id}.
Show me the files attached to card {id}.
Ask an LLM
“How do I attach a URL or upload a file to a card?”
“Can I give an attachment a name and MIME type when adding it?”
Tell an agent
Attach {url} to card {id}.
Add an attachment named {name} linking to {url} on card {id}.
Ask an LLM
“How do I see all the checklists on a card?”
“What checklists does a given card have?”
Tell an agent
List the checklists on card {id}.
Show every checklist attached to card {id}.
Ask an LLM
“How do I add a new checklist to a card?”
“Can I copy an existing checklist onto another card?”
Tell an agent
Create a checklist called {name} on card {id}.
Copy checklist {idChecklistSource} onto card {id}.
Ask an LLM
“How do I tag a card with one of the board's existing labels?”
“Can I apply a label to a card without creating a new one?”
Tell an agent
Apply label {value} to card {id}.
Tag card {id} with the existing board label {value}.
Ask an LLM
“How do I take a label off a card?”
“Does removing a label from a card delete the label from the board?”
Tell an agent destructive · confirm first
Take label {idLabel} off card {id}.
Unlabel card {id} by removing {idLabel}.
Ask an LLM
“How do I assign someone to a card?”
“Can I add a teammate to a card through the members endpoint?”
Tell an agent
Assign member {value} to card {id}.
Put {value} on card {id} as an assignee.
Ask an LLM
“Who is assigned to a particular card?”
“How do I get the members on a card?”
Tell an agent
List the members assigned to card {id}.
Show who is on card {id}.
Ask an LLM
“How do I unassign a person from a card?”
“What happens to a member's access when I take them off a card?”
Tell an agent destructive · confirm first
Unassign member {idMember} from card {id}.
Take {idMember} off card {id}.
Ask an LLM
“Which stickers have been placed on a card?”
“How do I get all stickers on one card?”
Tell an agent
List the stickers on card {id}.
Show all stickers placed on card {id}.
Ask an LLM
“How do I put a sticker on a card at a specific position?”
“Can I rotate a sticker when I add it to a card?”
Tell an agent
Stick {image} on card {id} at top {top}, left {left}, z-index {zIndex}.
Add sticker {image} to card {id} rotated {rotate} degrees at {top},{left} layer {zIndex}.
Ask an LLM
“Can I read just one property of a card, like its due date, without the whole card?”
“How do I fetch a single field value from a card?”
Tell an agent
Get only the {field} property of card {id}.
Read the {field} value on card {id}.
GET
/cards/{id}/attachments/{idAttachment}
Get one attachment on a card · Get an Attachment on a Card
#
Ask an LLM
“How do I look up a specific attachment on a card?”
“Can I get the details of one attachment by its id?”
Tell an agent
Show attachment {idAttachment} on card {id}.
Get the details of attachment {idAttachment} from card {id}.
DELETE
/cards/{id}/attachments/{idAttachment}
Delete an attachment from a card · Delete an Attachment on a Card
#
Ask an LLM
“How do I remove an attachment from a card?”
“Can I delete a file I attached to a card by mistake?”
Tell an agent destructive · confirm first
Delete attachment {idAttachment} from card {id}.
Remove the attached file {idAttachment} on card {id}.
Ask an LLM
“Which board does a given card belong to?”
“How do I get the board for a card I only have the id of?”
Tell an agent
Tell me which board card {id} is on.
Get the parent board of card {id}.
GET
/cards/{id}/checkItemStates
List completed checklist items on a card · Get checkItems on a Card
#
Ask an LLM
“Which checklist items on a card are already done?”
“How can I see checklist completion progress for one card?”
Tell an agent
List the completed checklist items on card {id}.
Show which check items are ticked off on card {id}.
GET
/cards/{id}/checkItem/{idCheckItem}
Get one checklist item on a card · Get checkItem on a Card
#
Ask an LLM
“How do I look up a single checklist item on a card?”
“Can I read one check item's state and name by its id?”
Tell an agent
Show check item {idCheckItem} on card {id}.
Get the state of checklist item {idCheckItem} on card {id}.
PUT
/cards/{id}/checkItem/{idCheckItem}
Update a checklist item on a card · Update a checkItem on a Card
#
Ask an LLM
“How do I mark a checklist item on a card complete?”
“Can I give a check item a due date, reminder or assignee?”
Tell an agent
Mark check item {idCheckItem} on card {id} as {state}.
Assign check item {idCheckItem} on card {id} to member {idMember}.
DELETE
/cards/{id}/checkItem/{idCheckItem}
Delete a checklist item from a card · Delete checkItem on a Card
#
Ask an LLM
“How do I delete a single checklist item from a card?”
“Can I remove one to-do from a card's checklist without deleting the checklist?”
Tell an agent destructive · confirm first
Delete check item {idCheckItem} from card {id}.
Remove the to-do {idCheckItem} on card {id}.
Ask an LLM
“Which list is a card currently sitting in?”
“How do I find out a card's column on the board?”
Tell an agent
Tell me which list card {id} is in.
Get the current list of card {id}.
GET
/cards/{id}/membersVoted
List members who voted on a card · Get Members who have voted on a Card
#
Ask an LLM
“Who has voted on a card?”
“How do I count the votes a card has received?”
Tell an agent
List the members who voted on card {id}.
Show the voters on card {id}.
Ask an LLM
“How do I vote on a card for a member?”
“Can an integration add an upvote to a card?”
Tell an agent
Vote on card {id} as member {value}.
Add an upvote from {value} to card {id}.
Ask an LLM
“What shared Power-Up data is stored on a card?”
“How can my Power-Up read the pluginData it saved on a card?”
Tell an agent
Get the shared pluginData on card {id}.
Read Power-Up data saved on card {id}.
Ask an LLM
“How do I look up a specific sticker on a card?”
“Can I see the position and rotation of one sticker?”
Tell an agent
Show sticker {idSticker} on card {id}.
Get the position of sticker {idSticker} on card {id}.
Ask an LLM
“How do I peel a sticker off a card?”
“Can I delete one sticker without affecting others on the card?”
Tell an agent destructive · confirm first
Remove sticker {idSticker} from card {id}.
Delete the sticker {idSticker} on card {id}.
Ask an LLM
“How do I move a sticker that's already on a card?”
“Can I change a sticker's rotation or layer after placing it?”
Tell an agent
Move sticker {idSticker} on card {id} to top {top}, left {left}, z-index {zIndex}.
Rotate sticker {idSticker} on card {id} by {rotate}, keeping it at {top},{left} layer {zIndex}.
PUT
/cards/{id}/actions/{idAction}/comments
Edit a comment on a card · Update Comment Action on a Card
#
Ask an LLM
“How do I edit a comment I already posted on a card?”
“Can I fix a typo in an existing card comment?”
Tell an agent
Change comment {idAction} on card {id} to read {text}.
Edit my card {id} comment {idAction} with the new text {text}.
DELETE
/cards/{id}/actions/{idAction}/comments
Delete a comment on a card · Delete a comment on a Card
#
Ask an LLM
“How do I delete a comment from a card?”
“Can I remove a comment someone left on my card?”
Tell an agent destructive · confirm first
Delete comment {idAction} on card {id}.
Remove the card {id} comment {idAction}.
PUT
/cards/{idCard}/customField/{idCustomField}/item
Set a custom field value on a card · Update Custom Field item on Card
#
Ask an LLM
“How do I fill in a custom field on a card?”
“Can I clear a single custom field value on a card?”
Tell an agent
Set custom field {idCustomField} on card {idCard}.
Clear the value of custom field {idCustomField} for card {idCard}.
PUT
/cards/{idCard}/customFields
Set several custom field values on a card · Update Multiple Custom Field items on Card
#
Ask an LLM
“Can I update multiple custom fields on a card in one request?”
“What's the bulk way to set or clear a card's custom field values?”
Tell an agent
Update these custom field items on card {idCard} at once: {customFieldItems}.
Bulk-set or clear several custom fields on card {idCard} in one request.
GET
/cards/{id}/customFieldItems
Get a card's custom field values · Get Custom Field Items for a Card
#
Ask an LLM
“What custom field values are set on a card?”
“How do I read a card's custom field items?”
Tell an agent
List the custom field values on card {id}.
Show custom field items filled in on card {id}.
Ask an LLM
“How do I append a label id to a card's idLabels array?”
“Can I add a label to a card through the idLabels endpoint instead of labels?”
Tell an agent
Append label id {value} to the idLabels of card {id}.
Use the idLabels endpoint to add {value} to card {id}.
Ask an LLM
“How do I push a member id onto a card's idMembers list?”
“Is there an idMembers endpoint for adding people to a card?”
Tell an agent
Append member id {value} to the idMembers of card {id}.
Use the idMembers endpoint to add {value} to card {id}.
POST
/cards/{id}/markAssociatedNotificationsRead
Mark a card's notifications read · Mark a Card's Notifications as read
#
Ask an LLM
“How do I clear all unread notifications about one card?”
“Can I mark every notification tied to a card as read?”
Tell an agent
Mark all notifications about card {id} as read.
Clear unread alerts for card {id}.
DELETE
/cards/{id}/idLabels/{idLabel}
Remove a label via a card's idLabels · Remove a Label from a Card
#
Ask an LLM
“How do I pull a label id out of a card's idLabels array?”
“Is there an idLabels endpoint for removing a label from a card?”
Tell an agent destructive · confirm first
Remove label id {idLabel} from the idLabels of card {id}.
Use the idLabels endpoint to drop {idLabel} from card {id}.
DELETE
/cards/{id}/idMembers/{idMember}
Remove a member via a card's idMembers · Remove a Member from a Card
#
Ask an LLM
“How do I pull a member id out of a card's idMembers list?”
“Is there an idMembers endpoint for taking someone off a card?”
Tell an agent destructive · confirm first
Remove member id {idMember} from the idMembers of card {id}.
Use the idMembers endpoint to drop {idMember} from card {id}.
DELETE
/cards/{id}/membersVoted/{idMember}
Remove a member's vote from a card · Remove a Member's Vote on a Card
#
Ask an LLM
“How do I withdraw a vote on a card?”
“Can I remove someone's vote from a card?”
Tell an agent destructive · confirm first
Remove the vote by {idMember} on card {id}.
Withdraw member {idMember}'s upvote from card {id}.
PUT
/cards/{idCard}/checklist/{idChecklist}/checkItem/{idCheckItem}
Reorder a check item within a card checklist · Update Checkitem on Checklist on Card
#
Ask an LLM
“How do I change the position of an item inside a specific checklist on a card?”
“Can I move a check item to the top of its checklist?”
Tell an agent
Move check item {idCheckItem} in checklist {idChecklist} on card {idCard} to position {pos}.
Reorder item {idCheckItem} of checklist {idChecklist} on card {idCard}.
DELETE
/cards/{id}/checklists/{idChecklist}
Delete a checklist from a card · Delete a Checklist on a Card
#
Ask an LLM
“How do I remove an entire checklist from a card?”
“Does deleting a card's checklist remove all of its items too?”
Tell an agent destructive · confirm first
Delete checklist {idChecklist} from card {id}.
Remove the whole checklist {idChecklist} on card {id}.