Trello

SDK reference for trello operations

Overview

Trello project management and collaboration

• Category: productivity
• Auth Required: Yes
• Supported Modes: standard, delegated

Operations

getBoards

Get all boards for the authenticated user

Returns:

AdapterOperationResult - Returns { boards[], count }. Each board has FLAT fields: id, name, description, url, closed, starred, listCount. No nested objects.

Response Fields:

| count | number | Number of boards returned |

Example:

const result = await mirra.trello.getBoards();

getBoard

Get a specific board by ID including its lists

Arguments:

• boardId (string, required): The ID of the board to retrieve

Returns:

AdapterOperationResult - Returns FLAT board fields: id, name, description, url, closed, starred, lists[], listCount. Each list has FLAT fields: id, name, closed, position, boardId.

Response Fields:

| listCount | number | Number of lists |

Example:

const result = await mirra.trello.getBoard({
  boardId: "abc123"
});

createCard

Create a new card in a Trello list

Arguments:

• name (string, required): Card name/title
• idList (string, required): ID of the list to add the card to
• desc (string, optional): Card description (supports markdown)

Returns:

AdapterOperationResult - Returns { card }. Card has FLAT fields: id, name, description, url, shortUrl, closed, position, listId, boardId, dueDate, dueComplete, labels[], checklistCount, attachmentCount, commentCount.

Response Fields:

Example:

const result = await mirra.trello.createCard({
  name: "example",
  idList: "abc123"
});

getCard

Get a specific card by ID

Arguments:

• cardId (string, required): The ID of the card to retrieve

Returns:

AdapterOperationResult - Returns { card }. Card has FLAT fields: id, name, description, url, shortUrl, closed, position, listId, boardId, dueDate, dueComplete, labels[], checklistCount, attachmentCount, commentCount.

Response Fields:

Example:

const result = await mirra.trello.getCard({
  cardId: "abc123"
});

updateCard

Update an existing card

Arguments:

• cardId (string, required): The ID of the card to update
• name (string, optional): New card name
• desc (string, optional): New card description
• idList (string, optional): Move card to a different list
• closed (boolean, optional): Archive the card

Returns:

AdapterOperationResult - Returns { card } with updated FLAT fields.

Response Fields:

Example:

const result = await mirra.trello.updateCard({
  cardId: "abc123"
});

deleteCard

Delete a card permanently

Arguments:

• cardId (string, required): The ID of the card to delete

Returns:

AdapterOperationResult - Returns { success, deletedId, deletedAt }. FLAT deletion confirmation.

Response Fields:

Example:

const result = await mirra.trello.deleteCard({
  cardId: "abc123"
});

createChecklist

Create a new checklist on a card

Arguments:

• cardId (string, required): The ID of the card to add the checklist to
• name (string, required): Checklist name

Returns:

AdapterOperationResult - Returns { checklist, checkItems[] }. Checklist has FLAT fields: id, name, cardId, boardId, position, checkItemCount, checkItemsChecked.

Response Fields:

| checkItems | TrelloCheckItem[] | Check items in the checklist |

Example:

const result = await mirra.trello.createChecklist({
  cardId: "abc123",
  name: "example"
});

getChecklist

Get a specific checklist by ID

Arguments:

• checklistId (string, required): The ID of the checklist to retrieve

Returns:

AdapterOperationResult - Returns { checklist, checkItems[] }. Each checkItem has FLAT fields: id, name, checklistId, state, position.

Response Fields:

| checkItems | TrelloCheckItem[] | Check items in the checklist |

Example:

const result = await mirra.trello.getChecklist({
  checklistId: "abc123"
});

updateChecklist

Update a checklist name

Arguments:

• checklistId (string, required): The ID of the checklist to update
• name (string, required): New checklist name

Returns:

AdapterOperationResult - Returns { checklist, checkItems[] } with updated FLAT fields.

Response Fields:

| checkItems | TrelloCheckItem[] | Check items in the checklist |

Example:

const result = await mirra.trello.updateChecklist({
  checklistId: "abc123",
  name: "example"
});

deleteChecklist

Delete a checklist from a card

Arguments:

• checklistId (string, required): The ID of the checklist to delete

Returns:

AdapterOperationResult - Returns { success, deletedId, deletedAt }. FLAT deletion confirmation.

Response Fields:

Example:

const result = await mirra.trello.deleteChecklist({
  checklistId: "abc123"
});

addCheckItem

Add a check item to a checklist

Arguments:

• checklistId (string, required): The ID of the checklist to add the item to
• name (string, required): Check item text

Returns:

AdapterOperationResult - Returns { checkItem }. CheckItem has FLAT fields: id, name, checklistId, state, position.

Response Fields:

Example:

const result = await mirra.trello.addCheckItem({
  checklistId: "abc123",
  name: "example"
});

updateCheckItem

Update a check item (name or completion state)

Arguments:

• cardId (string, required): The ID of the card containing the check item
• checkItemId (string, required): The ID of the check item to update
• name (string, optional): New check item text
• state (string, optional): Check state: "complete" or "incomplete"

Returns:

AdapterOperationResult - Returns { checkItem } with updated FLAT fields: id, name, checklistId, state, position.

Response Fields:

Example:

const result = await mirra.trello.updateCheckItem({
  cardId: "abc123",
  checkItemId: "abc123"
});

deleteCheckItem

Delete a check item from a checklist

Arguments:

• checklistId (string, required): The ID of the checklist containing the item
• checkItemId (string, required): The ID of the check item to delete

Returns:

AdapterOperationResult - Returns { success, deletedId, deletedAt }. FLAT deletion confirmation.

Response Fields:

Example:

const result = await mirra.trello.deleteCheckItem({
  checklistId: "abc123",
  checkItemId: "abc123"
});

discoverExtended

Search Trello API for available operations beyond core tools

Arguments:

• query (string, required): Describe what you want to do (e.g., "add label to card")
• limit (number, optional): Max results to return (default 5)

Returns:

AdapterOperationResult - List of matching operations with their details

Example:

const result = await mirra.trello.discoverExtended({
  query: "example"
});

executeExtended

Execute a Trello API operation by operationId

Arguments:

• operationId (string, required): The operationId from discoverExtended results
• pathParams (object, optional): Path parameters, e.g., { id: "abc123" }
• queryParams (object, optional): Query string parameters
• body (object, optional): Request body for POST/PUT/PATCH operations

Returns:

AdapterOperationResult - API response data

Example:

const result = await mirra.trello.executeExtended({
  operationId: "abc123"
});

Extended Operations

This adapter supports the full Trello API via OpenAPI discovery. Use discoverExtended to find operations and executeExtended to run them.