Trello

Procedures and concepts for the Trello integration.

The following documentation is for Trello v1.1.3 (BDK).

Overview

Trello is a visual project management tool that uses boards, lists, and cards to organize tasks and projects. This integration allows automated card creation, board management, team assignments, and project tracking workflows. Simplify project organization and enhance team collaboration.

Prerequisites

1. Required Books

The following Book(s) need to be added to your agent so it can learn and understand the automation procedures defined within them:

• Trello

How to Add the Book(s)

1. Go to Books → All Books.

2. Search for the name of the book and click on it.

3. Click on Install or Add Connection to add the book to your agent.

4. If adding a connection, you'll be prompted for connectivity details.

Connectivity

This section outlines the available methods for connecting to the Book, along with the required configuration details for each.

This books supports the connectivity methods described in this section.In here you will find information about what information is required in order to employ each method.

Connect using api key and token

Connects to the Trello Client using the provided client credentials.

Label	Description	Type
api key	The API key from your Trello Power-Up	text
token	The generated token from your Trello Power-Ups	sensitive

Procedures

to create a card in trello list

Creates a new card in a list.

Input Concepts

Concept	Description	Type	Required	Default Value
trello list	A Trello list to create the card in	trello list	Yes	(no default)
card	The new card	trello card	Yes	(no default)

Output Concepts

Concept	Description	Type
answer	the created card	trello card

Examples

Create a new card in a list

...
get some lists from the board
get the first list from lists
use the above as the todo
>>>
create a json
use the above as the card
set the card's name to "A very cool card name"
set the card's description to "A very cool card description"
>>>
create the card in the todo

to get some (board's lists)

Gets all lists from a board.

Input Concepts

Concept	Description	Type	Required	Default Value
board	The Trello board to get lists from	trello board	Yes	(no default)

Output Concepts

Concept	Description	Type
board's lists	a list of lists in the board	trello list

Examples

Get all lists from a board

get a board whose name is "Kognitos"
get some lists from the board

to get some (boards)

FILTER - CAPABLE

Gets all boards from your Trello account.

Output Concepts

Concept	Description	Type
boards	A list of Trello boards	trello board

Examples

Get all boards

get some boards

Get a board by name

get a board whose name is "Kognitos"

to move a card to a trello list

Updates a card in a list.

Input Concepts

Concept	Description	Type	Required	Default Value
trello list	The destination Trello list to move the card to	trello list	Yes	(no default)
card	The Trello card to be moved	trello card	Yes	(no default)

Output Concepts

Concept	Description	Type
answer	the moved card	trello card

Examples

Create a card and move it to another list

...
get some lists from the board
get the first list from lists
use the above as the todo
>>>
create a json
use the above as the card
set the card's name to "A very cool card name"
set the card's description to "A very cool card description"
>>>
create the card in the todo
>>>
get the second list from lists
use the above as the in progress
>>>
move the card to the in progress

Concepts

Trello list

Lists are used to organize cards (individual tasks or pieces of information) within a board.

Field Name	Description	Type
id	The id of the list	text
name	The name of the list	text

Trello card

Cards represent individual tasks or items of information and can include details like descriptions, due dates, labels, and attachments to help organize and track work.

Field Name	Description	Type
id	The id of the card	optional[text]
name	The name of the card	text
description	The description of the card	optional[text]
short_url	The short URL of the card	optional[text]
list_id	The id of the list the card belongs to	optional[text]

Trello board

A board is a workspace for organizing and tracking tasks, projects, and information in Trello.

Field Name	Description	Type
id	The id of the board	optional[text]
name	The name of the board	text