Trello · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Trello Cards API

46 actions 46 updates phrasing extends openapi/trello-cards-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Trello's API. It is a proposal applied on top of the contract, not a document Trello publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 46 · first 16 shown; the file carries all of them

$.info
$.paths['/cards'].post
$.paths['/cards/{id}'].get
$.paths['/cards/{id}'].put
$.paths['/cards/{id}'].delete
$.paths['/cards/{id}/actions'].get
$.paths['/cards/{id}/actions/comments'].post
$.paths['/cards/{id}/attachments'].get
$.paths['/cards/{id}/attachments'].post
$.paths['/cards/{id}/checklists'].get
$.paths['/cards/{id}/checklists'].post
$.paths['/cards/{id}/labels'].post
$.paths['/cards/{id}/labels/{idLabel}'].delete
$.paths['/cards/{id}/members'].get
$.paths['/cards/{id}/members'].post
$.paths['/cards/{id}/members/{idMember}'].delete

OpenAPI Overlay

Raw ↑
# 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'

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/trello-cards-api-phrasing-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.