TrelloDotNet 1.6.5

TrelloDotNet

Welcome to TrelloDotNet; a modern .NET Implementation of the Trello API.

Features

• A TrelloClient implementing the Trello API for CRUD operations on most Trello Features
• An Automation Engine and Webhook Data Reciver for handling Webhook Events from a Trello Board

How to get started

1. Install the 'TrelloDotNet' NuGet Package (dotnet add package TrelloDotNet)
2. Retrieve your API-Key and Token
3. Create new instance of TrelloDotNet.TrelloClient
4. Locate you Ids of you Boards, List and Cards (see video here or at the end on this ReadMe)
5. Use the TrelloClient based on the examples below and/or the Wiki.

Examples of Usage:

TrelloClient client = new TrelloClient("APIKey", "TOKEN"); //IMPORTANT: Remember to not leave Key and Token in clear text!

//Get a board
Board board = await client.GetBoardAsync("<boardId>");

//Get Lists on a board
List<List> lists = await client.GetCardsOnBoardAsync("<boardId>");

//Get a card
Card card = await client.GetCardAsync("<cardId>");

//Get Cards on Board
List<Card> cardsOnBoard = await trelloClient.GetCardsOnBoardAsync("<boardId>");

//Get Cards in List
List<Card> cardsInList = await trelloClient.GetCardsInListAsync("<listId>");

//Add a card
var input = new Card("<listId>", "My Card", "My Card description");
//todo - add more about the card 
var newCard = await client.AddCardAsync(input);

//Add a Checklist to a card
var checklistItems = new List<ChecklistItem>
{
    new("ItemA"),
    new("ItemB"),
    new("ItemC")
};
var newChecklist = new Checklist("Sample Checklist", checklistItems);
var addedChecklist = await client.AddChecklistAsync("<cardId>", newChecklist);

Version History

• Changelog

Video Guides

• How to get your API-Key and Token
• How to Find ids on a Trello Board
• How to use the TrelloDotNet NuGet Package
• How to work with Webhooks (Part 1: Setup)
• How to work with Webhooks (Part 2: Receiving Events)

Other handy links

• Admin Center for API Keys and Tokens: https://trello.com/power-ups/admin/
• REST API Documentation from Trello: https://developer.atlassian.com/cloud/trello/rest

On the subject of getting Ids from Trello

• The easiest way to get Ids in Trello is to use this Power-Up to copy/paste them (Recommended)...

• or use the API itself or use the share buttons in the project (require no Power-Up but more cumbersome)

The Export looks like this (search for id or use a tool to pretty-print the JSON to get a better view)

More info, bugs, or questions?

Visit the Github Page: https://github.com/rwjdk/TrelloDotNet

Have Fun 😃