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

Log in to Trello and visit trello.com/app-key to get a token and app key. 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
  })

Requests to API endpoints, not supported by this lib yet

    // Get all registered tokens and webhooks
    // Url will look like: https://api.trello.com/1/members/me/tokens?webhooks=true&key=YOURKEY&token=YOURTOKEN
    trello.makeRequest('get', '/1/members/me/tokens', { webhooks: true })
      .then((res) => {
          console.log(res)
      });

Available functions

Add

• addAttachmentToCard
• addBoard
• addCard
• addCardWithExtraParams
• addChecklistToCard
• addCommentToCard
• addCustomField
• addDueDateToCard
• addExistingChecklistToCard
• addItemToChecklist
• addLabelOnBoard
• addLabelToCard
• addListToBoard
• addMemberToBoard
• addMemberToCard
• addOptionToCustomField
• addStickerToCard
• addWebhook
• copyBoard
• setCustomFieldOnCard

Delete

• deleteCard
• deleteLabel
• deleteLabelFromCard
• delMemberFromCard
• deleteWebhook

Get

• getActionsOnBoard
• getBoardMembers
• getBoards
• getCard
• getCardsForList
• getCardsOnBoard
• getCardsOnBoardWithExtraParams
• getCardsOnList
• getCardsOnListWithExtraParams
• getCardStickers
• getChecklistsOnCard
• getCustomFieldsOnBoard
• getLabelsForBoard
• getListsOnBoard
• getListsOnBoardByFilter
• getMember
• getMemberCards
• getOrganization
• getOrgBoards
• getOrgMembers

Update

• renameList
• updateBoardPref
• updateCard
• updateCardDescription
• updateCardList
• updateCardName
• updateCardPos
• updateChecklist
• updateLabel
• updateLabelColor
• updateLabelName

Everything that is not available as a function can be requested by calling makeRequest.

History

0.13.0

• Add function getOrganization

0.12.0

• Replaced restler with needle

0.11.0

• Update optional fields
• Add optional field queries
• Add function addCustomField
• Add function addOptionToCustomField
• Add function setCustomFieldOnCard
• Add function updateCardPos
• Add function delMemberFromCard

0.10.0

• Add copyBoard functionality
• Add getCustomFieldsOnBoard
• Add getActionsOnBoard

0.9.1

• Added trailing slash to /boards/ call

0.9.0

• New function getCardsOnBoardWithExtraParams
• New function getCardsOnListWithExtraParams
• New function addDueDateToCard

0.8.0

• Rename list fixed
• Handle API rate limit by retries
• New function addCardWithExtraParams

0.7.0

• Public visibility for makeRequest

0.6.0

• added getMember
• added getCardStickers
• added addStickerToCard
• added getOrgBoards
• added getMemberCards
• added updateBoardPref
• added addMemberToBoard

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