jan/trello

Use the Trello API from Node

trello

A simple asynchronous client for Trello

This is a wrapper for some of the Trello HTTP API. Please feel free to add any other pieces you need! :)

Installation

npm install trello

Usage

First, generate your Trello application key like this, then follow these confusing instructions to get a user token. These need to be supplied when you create the Trello object (see below).

Example

  var Trello = require("trello");
  var trello = new Trello("MY APPLICATION KEY", "MY USER TOKEN");

  trello.addCard('Clean car', 'Wax on, wax off', myListId,
      function (error, trelloCard) {
          if (error) {
              console.log('Could not add card:', error);
          }
          else {
              console.log('Added card:', trelloCard);
          }
      });

Callback or promise

API calls can either execute a callback or return a promise. To return a promise just omit the callback parameter.

  //Callback
  trello.getCardsOnList(listId, callback);

  //Promise
  var cardsPromise = trello.getCardsOnList(listId);
  cardsPromise.then((cards) => {
    //do stuff
  })

History

0.5.1

• added renameList
• added addChecklistToCard
• added getChecklistsOnCard
• added addExistingChecklistToCard
• added updateChecklist
• added getOrgMembers
• API methods now return the promise

0.5.0

• Support of promises
• Basic support of Labeling:
  • getLabelsForBoard
  • addLabelOnBoard
  • deleteLabel
  • addLabelToCard
  • deleteLabelFromCard

0.4.1

• Updated dev dependencies

0.4.0

• One-time listener
• addAttachmentToCard added
• Updated restler dependency
• Node.js support >= 0.10.x / removed 0.6 and 0.8

0.3.0

• Project trello_ex merged again with original project trello
• Using 'restler' again

0.2.0

• getBoards added