# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Trello Cards API version: 1.0.0 extends: openapi/trello-cards-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-10-02' generator: build-phrasing.py label: Generated by API Evangelist operations: 45 - target: $.paths['/cards'].post update: x-apievangelist-phrasing: intent: Create a card on a list effect: write questions: - 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? - Is it possible to create a card by copying an existing card? instructions: - text: Create a card called {name} on list {idList}. slots: name: query.name idList: query.idList - text: Add a new card to list {idList} due {due} with description {desc}. slots: idList: query.idList due: query.due desc: query.desc - text: Copy card {idCardSource} into list {idList} as a new card. slots: idCardSource: query.idCardSource idList: query.idList method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}'].get update: x-apievangelist-phrasing: intent: Get a card's details effect: read questions: - 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? instructions: - text: Show me card {id} with its checklists and attachments. slots: id: path.id - text: Fetch the details of card {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}'].put update: x-apievangelist-phrasing: intent: Update a card's fields effect: write questions: - 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? - Is there a way to archive a card or mark its due date complete? instructions: - text: Rename card {id} to {name}. slots: id: path.id name: query.name - text: Move card {id} to list {idList}. slots: id: path.id idList: query.idList - text: Change the due date on card {id} to {due}. slots: id: path.id due: query.due method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}'].delete update: x-apievangelist-phrasing: intent: Permanently delete a card effect: destructive questions: - How do I permanently delete a card rather than archive it? - Can a deleted card be restored afterwards? instructions: - text: Permanently delete card {id}. slots: id: path.id - text: Remove card {id} for good, no archive. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/actions'].get update: x-apievangelist-phrasing: intent: List activity on a card effect: read questions: - Where can I see the activity history of a card? - Can I filter a card's activity to only comments? instructions: - text: Show the activity history for card {id}. slots: id: path.id - text: List only the {filter} actions on card {id}. slots: filter: query.filter id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/actions/comments'].post update: x-apievangelist-phrasing: intent: Comment on a card effect: write questions: - How do I post a comment on a card through the API? - Can an integration leave notes on a card as comments? instructions: - text: Comment {text} on card {id}. slots: text: query.text id: path.id - text: Post a new comment to card {id} saying {text}. slots: id: path.id text: query.text method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/attachments'].get update: x-apievangelist-phrasing: intent: List a card's attachments effect: read questions: - Which files and links are attached to a card? - How do I get every attachment on one card? instructions: - text: List all attachments on card {id}. slots: id: path.id - text: Show me the files attached to card {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/attachments'].post update: x-apievangelist-phrasing: intent: Attach a file or link to a card effect: write questions: - 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? instructions: - text: Attach {url} to card {id}. slots: url: query.url id: path.id - text: Add an attachment named {name} linking to {url} on card {id}. slots: name: query.name url: query.url id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/checklists'].get update: x-apievangelist-phrasing: intent: List checklists on a card effect: read questions: - How do I see all the checklists on a card? - What checklists does a given card have? instructions: - text: List the checklists on card {id}. slots: id: path.id - text: Show every checklist attached to card {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/checklists'].post update: x-apievangelist-phrasing: intent: Add a checklist to a card effect: write questions: - How do I add a new checklist to a card? - Can I copy an existing checklist onto another card? instructions: - text: Create a checklist called {name} on card {id}. slots: name: query.name id: path.id - text: Copy checklist {idChecklistSource} onto card {id}. slots: idChecklistSource: query.idChecklistSource id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/labels'].post update: x-apievangelist-phrasing: intent: Apply an existing label to a card effect: write questions: - 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? instructions: - text: Apply label {value} to card {id}. slots: value: query.value id: path.id - text: Tag card {id} with the existing board label {value}. slots: id: path.id value: query.value method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/labels/{idLabel}'].delete update: x-apievangelist-phrasing: intent: Remove a label from a card effect: destructive questions: - How do I take a label off a card? - Does removing a label from a card delete the label from the board? instructions: - text: Take label {idLabel} off card {id}. slots: idLabel: path.idLabel id: path.id - text: Unlabel card {id} by removing {idLabel}. slots: id: path.id idLabel: path.idLabel method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/members'].get update: x-apievangelist-phrasing: intent: List members assigned to a card effect: read questions: - Who is assigned to a particular card? - How do I get the members on a card? instructions: - text: List the members assigned to card {id}. slots: id: path.id - text: Show who is on card {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/members'].post update: x-apievangelist-phrasing: intent: Assign a member to a card effect: write questions: - How do I assign someone to a card? - Can I add a teammate to a card through the members endpoint? instructions: - text: Assign member {value} to card {id}. slots: value: query.value id: path.id - text: Put {value} on card {id} as an assignee. slots: value: query.value id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/members/{idMember}'].delete update: x-apievangelist-phrasing: intent: Unassign a member from a card effect: destructive questions: - How do I unassign a person from a card? - What happens to a member's access when I take them off a card? instructions: - text: Unassign member {idMember} from card {id}. slots: idMember: path.idMember id: path.id - text: Take {idMember} off card {id}. slots: idMember: path.idMember id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/stickers'].get update: x-apievangelist-phrasing: intent: List stickers on a card effect: read questions: - Which stickers have been placed on a card? - How do I get all stickers on one card? instructions: - text: List the stickers on card {id}. slots: id: path.id - text: Show all stickers placed on card {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/stickers'].post update: x-apievangelist-phrasing: intent: Place a sticker on a card effect: write questions: - 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? instructions: - text: Stick {image} on card {id} at top {top}, left {left}, z-index {zIndex}. slots: image: query.image id: path.id top: query.top left: query.left zIndex: query.zIndex - text: Add sticker {image} to card {id} rotated {rotate} degrees at {top},{left} layer {zIndex}. slots: image: query.image id: path.id rotate: query.rotate top: query.top left: query.left zIndex: query.zIndex method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/{field}'].get update: x-apievangelist-phrasing: intent: Get one property of a card effect: read questions: - 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? instructions: - text: Get only the {field} property of card {id}. slots: field: path.field id: path.id - text: Read the {field} value on card {id}. slots: field: path.field id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/attachments/{idAttachment}'].get update: x-apievangelist-phrasing: intent: Get one attachment on a card effect: read questions: - How do I look up a specific attachment on a card? - Can I get the details of one attachment by its id? instructions: - text: Show attachment {idAttachment} on card {id}. slots: idAttachment: path.idAttachment id: path.id - text: Get the details of attachment {idAttachment} from card {id}. slots: idAttachment: path.idAttachment id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/attachments/{idAttachment}'].delete update: x-apievangelist-phrasing: intent: Delete an attachment from a card effect: destructive questions: - How do I remove an attachment from a card? - Can I delete a file I attached to a card by mistake? instructions: - text: Delete attachment {idAttachment} from card {id}. slots: idAttachment: path.idAttachment id: path.id - text: Remove the attached file {idAttachment} on card {id}. slots: idAttachment: path.idAttachment id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/board'].get update: x-apievangelist-phrasing: intent: Find which board a card is on effect: read questions: - Which board does a given card belong to? - How do I get the board for a card I only have the id of? instructions: - text: Tell me which board card {id} is on. slots: id: path.id - text: Get the parent board of card {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/checkItemStates'].get update: x-apievangelist-phrasing: intent: List completed checklist items on a card effect: read questions: - Which checklist items on a card are already done? - How can I see checklist completion progress for one card? instructions: - text: List the completed checklist items on card {id}. slots: id: path.id - text: Show which check items are ticked off on card {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/checkItem/{idCheckItem}'].get update: x-apievangelist-phrasing: intent: Get one checklist item on a card effect: read questions: - 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? instructions: - text: Show check item {idCheckItem} on card {id}. slots: idCheckItem: path.idCheckItem id: path.id - text: Get the state of checklist item {idCheckItem} on card {id}. slots: idCheckItem: path.idCheckItem id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/checkItem/{idCheckItem}'].put update: x-apievangelist-phrasing: intent: Update a checklist item on a card effect: write questions: - How do I mark a checklist item on a card complete? - Can I give a check item a due date, reminder or assignee? - Is it possible to move a check item to another checklist? instructions: - text: Mark check item {idCheckItem} on card {id} as {state}. slots: idCheckItem: path.idCheckItem id: path.id state: query.state - text: Assign check item {idCheckItem} on card {id} to member {idMember}. slots: idCheckItem: path.idCheckItem id: path.id idMember: query.idMember - text: Rename check item {idCheckItem} on card {id} to {name} and set due {due}. slots: idCheckItem: path.idCheckItem id: path.id name: query.name due: query.due method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/checkItem/{idCheckItem}'].delete update: x-apievangelist-phrasing: intent: Delete a checklist item from a card effect: destructive questions: - 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? instructions: - text: Delete check item {idCheckItem} from card {id}. slots: idCheckItem: path.idCheckItem id: path.id - text: Remove the to-do {idCheckItem} on card {id}. slots: idCheckItem: path.idCheckItem id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/list'].get update: x-apievangelist-phrasing: intent: Find which list a card is in effect: read questions: - Which list is a card currently sitting in? - How do I find out a card's column on the board? instructions: - text: Tell me which list card {id} is in. slots: id: path.id - text: Get the current list of card {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/membersVoted'].get update: x-apievangelist-phrasing: intent: List members who voted on a card effect: read questions: - Who has voted on a card? - How do I count the votes a card has received? instructions: - text: List the members who voted on card {id}. slots: id: path.id - text: Show the voters on card {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/membersVoted'].post update: x-apievangelist-phrasing: intent: Cast a member's vote on a card effect: write questions: - How do I vote on a card for a member? - Can an integration add an upvote to a card? instructions: - text: Vote on card {id} as member {value}. slots: id: path.id value: query.value - text: Add an upvote from {value} to card {id}. slots: value: query.value id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/pluginData'].get update: x-apievangelist-phrasing: intent: Get Power-Up data stored on a card effect: read questions: - What shared Power-Up data is stored on a card? - How can my Power-Up read the pluginData it saved on a card? instructions: - text: Get the shared pluginData on card {id}. slots: id: path.id - text: Read Power-Up data saved on card {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/stickers/{idSticker}'].get update: x-apievangelist-phrasing: intent: Get one sticker on a card effect: read questions: - How do I look up a specific sticker on a card? - Can I see the position and rotation of one sticker? instructions: - text: Show sticker {idSticker} on card {id}. slots: idSticker: path.idSticker id: path.id - text: Get the position of sticker {idSticker} on card {id}. slots: idSticker: path.idSticker id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/stickers/{idSticker}'].put update: x-apievangelist-phrasing: intent: Reposition a sticker on a card effect: write questions: - How do I move a sticker that's already on a card? - Can I change a sticker's rotation or layer after placing it? instructions: - text: Move sticker {idSticker} on card {id} to top {top}, left {left}, z-index {zIndex}. slots: idSticker: path.idSticker id: path.id top: query.top left: query.left zIndex: query.zIndex - text: Rotate sticker {idSticker} on card {id} by {rotate}, keeping it at {top},{left} layer {zIndex}. slots: idSticker: path.idSticker id: path.id rotate: query.rotate top: query.top left: query.left zIndex: query.zIndex method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/stickers/{idSticker}'].delete update: x-apievangelist-phrasing: intent: Remove a sticker from a card effect: destructive questions: - How do I peel a sticker off a card? - Can I delete one sticker without affecting others on the card? instructions: - text: Remove sticker {idSticker} from card {id}. slots: idSticker: path.idSticker id: path.id - text: Delete the sticker {idSticker} on card {id}. slots: idSticker: path.idSticker id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/actions/{idAction}/comments'].put update: x-apievangelist-phrasing: intent: Edit a comment on a card effect: write questions: - How do I edit a comment I already posted on a card? - Can I fix a typo in an existing card comment? instructions: - text: Change comment {idAction} on card {id} to read {text}. slots: idAction: path.idAction id: path.id text: query.text - text: Edit my card {id} comment {idAction} with the new text {text}. slots: id: path.id idAction: path.idAction text: query.text method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/actions/{idAction}/comments'].delete update: x-apievangelist-phrasing: intent: Delete a comment on a card effect: destructive questions: - How do I delete a comment from a card? - Can I remove a comment someone left on my card? instructions: - text: Delete comment {idAction} on card {id}. slots: idAction: path.idAction id: path.id - text: Remove the card {id} comment {idAction}. slots: id: path.id idAction: path.idAction method: generated generated: '2026-09-26' - target: $.paths['/cards/{idCard}/customField/{idCustomField}/item'].put update: x-apievangelist-phrasing: intent: Set a custom field value on a card effect: write questions: - How do I fill in a custom field on a card? - Can I clear a single custom field value on a card? instructions: - text: Set custom field {idCustomField} on card {idCard}. slots: idCustomField: path.idCustomField idCard: path.idCard - text: Clear the value of custom field {idCustomField} for card {idCard}. slots: idCustomField: path.idCustomField idCard: path.idCard method: generated generated: '2026-09-26' - target: $.paths['/cards/{idCard}/customFields'].put update: x-apievangelist-phrasing: intent: Set several custom field values on a card effect: write questions: - 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? instructions: - text: 'Update these custom field items on card {idCard} at once: {customFieldItems}.' slots: idCard: path.idCard customFieldItems: requestBody.customFieldItems - text: Bulk-set or clear several custom fields on card {idCard} in one request. slots: idCard: path.idCard method: generated generated: '2026-10-02' - target: $.paths['/cards/{id}/customFieldItems'].get update: x-apievangelist-phrasing: intent: Get a card's custom field values effect: read questions: - What custom field values are set on a card? - How do I read a card's custom field items? instructions: - text: List the custom field values on card {id}. slots: id: path.id - text: Show custom field items filled in on card {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/idLabels'].post update: x-apievangelist-phrasing: intent: Add a label via a card's idLabels effect: write questions: - 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? instructions: - text: Append label id {value} to the idLabels of card {id}. slots: value: query.value id: path.id - text: Use the idLabels endpoint to add {value} to card {id}. slots: value: query.value id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/idMembers'].post update: x-apievangelist-phrasing: intent: Add a member via a card's idMembers effect: write questions: - How do I push a member id onto a card's idMembers list? - Is there an idMembers endpoint for adding people to a card? instructions: - text: Append member id {value} to the idMembers of card {id}. slots: value: query.value id: path.id - text: Use the idMembers endpoint to add {value} to card {id}. slots: value: query.value id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/markAssociatedNotificationsRead'].post update: x-apievangelist-phrasing: intent: Mark a card's notifications read effect: write questions: - How do I clear all unread notifications about one card? - Can I mark every notification tied to a card as read? instructions: - text: Mark all notifications about card {id} as read. slots: id: path.id - text: Clear unread alerts for card {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/idLabels/{idLabel}'].delete update: x-apievangelist-phrasing: intent: Remove a label via a card's idLabels effect: destructive questions: - 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? instructions: - text: Remove label id {idLabel} from the idLabels of card {id}. slots: idLabel: path.idLabel id: path.id - text: Use the idLabels endpoint to drop {idLabel} from card {id}. slots: idLabel: path.idLabel id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/idMembers/{idMember}'].delete update: x-apievangelist-phrasing: intent: Remove a member via a card's idMembers effect: destructive questions: - 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? instructions: - text: Remove member id {idMember} from the idMembers of card {id}. slots: idMember: path.idMember id: path.id - text: Use the idMembers endpoint to drop {idMember} from card {id}. slots: idMember: path.idMember id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/membersVoted/{idMember}'].delete update: x-apievangelist-phrasing: intent: Remove a member's vote from a card effect: destructive questions: - How do I withdraw a vote on a card? - Can I remove someone's vote from a card? instructions: - text: Remove the vote by {idMember} on card {id}. slots: idMember: path.idMember id: path.id - text: Withdraw member {idMember}'s upvote from card {id}. slots: idMember: path.idMember id: path.id method: generated generated: '2026-09-26' - target: $.paths['/cards/{idCard}/checklist/{idChecklist}/checkItem/{idCheckItem}'].put update: x-apievangelist-phrasing: intent: Reorder a check item within a card checklist effect: write questions: - 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? instructions: - text: Move check item {idCheckItem} in checklist {idChecklist} on card {idCard} to position {pos}. slots: idCheckItem: path.idCheckItem idChecklist: path.idChecklist idCard: path.idCard pos: query.pos - text: Reorder item {idCheckItem} of checklist {idChecklist} on card {idCard}. slots: idCheckItem: path.idCheckItem idChecklist: path.idChecklist idCard: path.idCard method: generated generated: '2026-09-26' - target: $.paths['/cards/{id}/checklists/{idChecklist}'].delete update: x-apievangelist-phrasing: intent: Delete a checklist from a card effect: destructive questions: - How do I remove an entire checklist from a card? - Does deleting a card's checklist remove all of its items too? instructions: - text: Delete checklist {idChecklist} from card {id}. slots: idChecklist: path.idChecklist id: path.id - text: Remove the whole checklist {idChecklist} on card {id}. slots: idChecklist: path.idChecklist id: path.id method: generated generated: '2026-09-26'