Checklists

Checklists are nested sub-tasks on a card. Each checklist has a name and a list of items.

Create a checklist on a card

const checklist = await trello.cards.createCardChecklist({
  id: cardId,
  name: 'Release checklist',
});

Get a checklist

const checklist = await trello.checklists.getChecklist({ id: checklistId });
const items = await trello.checklists.getChecklistItems({ id: checklistId });

Add a check item

const item = await trello.checklists.createChecklistItem({
  id: checklistId,
  name: 'Update CHANGELOG',
  checked: false,
  pos: 'bottom',
});

Toggle a check item's state

await trello.cards.updateCardChecklistItem({
  id: cardId,
  idCheckItem: itemId,
  state: 'complete', // or 'incomplete'
});

The update goes through the card, not the checklist — that's how Trello scopes per-card state.

Rename a checklist

await trello.checklists.updateChecklist({
  id: checklistId,
  name: 'Release v2.0.0',
});

Delete an item / a whole checklist

await trello.checklists.deleteChecklistItem({ id: checklistId, idCheckItem: itemId });
await trello.checklists.deleteChecklist({ id: checklistId });

Copy a checklist to another card

const copy = await trello.cards.createCardChecklist({
  id: targetCardId,
  idChecklistSource: checklistId,
});