trello Boards API

Operations for creating, retrieving, updating, and deleting boards, as well as managing board memberships, lists, cards, labels, and other board-level resources.

Business capability
Project Management BC-900.30

Operations 43

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /boards Create a board · Create a Board #
Ask an LLM
“How do I create a new Trello board with a name and description?”
“Can I make a board inside a specific workspace and set it private or public?”
Tell an agent
Create a board named {name}.
Make a new board {name} in workspace {idOrganization} with permission level {permissionLevel}.
GET /boards/{id} Get a board's details · Get a Board #
Ask an LLM
“How do I fetch a board along with its lists, cards and labels in one call?”
“What information can I get about a single board?”
Tell an agent
Show me board {id}.
Get board {id} including its nested lists, cards and members.
PUT /boards/{id} Update a board's settings · Update a Board #
Ask an LLM
“How do I rename a board or change its description?”
“Can I close a board or move it to a different workspace?”
Tell an agent
Rename board {id} to {name}.
Set the permission level of board {id} to {permissionLevel}.
DELETE /boards/{id} Permanently delete a board · Delete a Board #
Ask an LLM
“How do I permanently delete a board?”
“Is deleting a board reversible, or should I close it instead?”
Tell an agent destructive · confirm first
Permanently delete board {id}.
Destroy board {id} and everything on it.
GET /boards/{id}/actions List recent activity on a board · Get Actions for a Board #
Ask an LLM
“How do I see the recent activity feed for a board?”
“Can I cap how many board activity events come back?”
Tell an agent
Show the last {limit} activity events on board {id}.
List board {id} activity of type {filter}.
GET /boards/{id}/cards List all cards on a board · Get Cards on a Board #
Ask an LLM
“How do I get every card on a board?”
“Can I choose which card fields come back when listing a board's cards?”
Tell an agent
List all cards on board {id}.
Get the cards on board {id} with only the fields {fields}.
GET /boards/{id}/cards/{filter} List a board's cards by status · Get Filtered Cards on a Board #
Ask an LLM
“How do I get only the open or only the archived cards on a board?”
“Which status filters can I apply to a board's cards?”
Tell an agent
List the {filter} cards on board {id}.
Show only archived cards on board {id}, filter {filter}.
GET /boards/{id}/checklists List all checklists on a board · Get Checklists on a Board #
Ask an LLM
“How do I pull every checklist across a whole board?”
“Can I see all checklists on a board without going card by card?”
Tell an agent
List every checklist on board {id}.
Get all board {id} checklists.
GET /boards/{id}/labels List labels defined on a board · Get Labels on a Board #
Ask an LLM
“Which labels are available on a board?”
“How do I get a board's label names and colors?”
Tell an agent
List the labels on board {id}.
Show up to {limit} labels defined on board {id}.
POST /boards/{id}/labels Create a label on a board · Create a Label on a Board #
Ask an LLM
“How do I add a new colored label to a board?”
“Can I create a label with a custom name and color?”
Tell an agent
Create a {color} label called {name} on board {id}.
Add label {name} with color {color} to board {id}.
GET /boards/{id}/lists List the lists on a board · Get Lists on a Board #
Ask an LLM
“How do I get all the columns on a board?”
“Can I fetch a board's lists together with their cards?”
Tell an agent
List the lists on board {id}.
Get board {id}'s lists with their cards included ({cards}).
POST /boards/{id}/lists Add a list to a board · Create a List on a Board #
Ask an LLM
“How do I add a new column to a board?”
“Can I choose where a new list appears on the board?”
Tell an agent
Add a list named {name} to board {id}.
Create list {name} on board {id} at position {pos}.
GET /boards/{id}/members List members of a board · Get Members of a Board #
Ask an LLM
“Who are the members of a board?”
“How do I get everyone who has access to a board?”
Tell an agent
List the members of board {id}.
Show who belongs to board {id}.
PUT /boards/{id}/members Invite someone to a board by email · Invite a Member to a Board #
Ask an LLM
“How do I invite a person to a board using their email address?”
“Can I invite someone to a board as an admin or observer?”
Tell an agent
Invite {email} to board {id}.
Invite {email} to board {id} as a {type}.
PUT /boards/{id}/members/{idMember} Change a board member's role · Update a Board Member #
Ask an LLM
“How do I make an existing board member an admin?”
“Can I downgrade a board member to observer by their member id?”
Tell an agent
Make member {idMember} a {type} on board {id}.
Change the role of {idMember} on board {id} to {type}.
DELETE /boards/{id}/members/{idMember} Remove a member from a board · Remove a Member from a Board #
Ask an LLM
“How do I kick someone off a board?”
“Can I revoke a person's access to a board?”
Tell an agent destructive · confirm first
Remove member {idMember} from board {id}.
Revoke {idMember}'s access to board {id}.
GET /boards/{id}/memberships List board membership records · Get Memberships of a Board #
Ask an LLM
“How do I see each board member's membership type?”
“Can I filter a board's memberships to admins only?”
Tell an agent
List the membership records for board {id}.
Show board {id} memberships filtered to {filter}.
GET /boards/{id}/{field} Get one field of a board · Get a field on a Board #
Ask an LLM
“Can I read just a board's name or description without the whole board?”
“How do I fetch a single property from a board?”
Tell an agent
Get only the {field} of board {id}.
Read the {field} property on board {id}.
GET /boards/{boardId}/actions Page through a board's actions by date · Get Actions of a Board #
Ask an LLM
“How do I page through a board's full action history between two dates?”
“Can I get board actions since a certain date with their reactions?”
Tell an agent
Get actions on board {boardId} since {since}.
Fetch page {page} of board {boardId} actions before {before}.
GET /boards/{boardId}/boardStars List stars on a board · Get boardStars on a Board #
Ask an LLM
“Who has starred a board?”
“Can I see only my own star on a board?”
Tell an agent
List the stars on board {boardId}.
Show board {boardId} stars filtered by {filter}.
GET /boards/{id}/customFields List custom field definitions on a board · Get Custom Fields for Board #
Ask an LLM
“Which custom fields are defined on a board?”
“How do I get a board's custom field definitions?”
Tell an agent
List the custom field definitions on board {id}.
Show what custom fields board {id} has.
GET /boards/{id}/lists/{filter} List a board's lists by open or closed · Get filtered Lists on a Board #
Ask an LLM
“How do I get only the archived lists on a board?”
“Can I filter a board's lists to open ones via a path filter?”
Tell an agent
Filter board {id} columns down to only {filter} ones.
Show archived columns on board {id} using filter {filter}.
PUT /boards/{id}/memberships/{idMembership} Change a board membership's type · Update Membership of Member on a Board #
Ask an LLM
“How do I change a membership's type using the membership id rather than the member id?”
“Can I switch a board membership from normal to admin?”
Tell an agent
Set membership {idMembership} on board {id} to type {type}.
Update board {id} membership record {idMembership} to {type}.
PUT /boards/{id}/myPrefs/emailPosition Set where emailed cards land in a list · Update emailPosition Pref on a Board #
Ask an LLM
“Can cards I email to a board go to the top of the list instead of the bottom?”
“How do I change my emailPosition preference on a board?”
Tell an agent
Put emailed cards at the {value} of the list on board {id}.
Set my email position pref on board {id} to {value}.
PUT /boards/{id}/myPrefs/idEmailList Set the default list for emailed cards · Update idEmailList Pref on a Board #
Ask an LLM
“Which list do cards created by email-to-board go into, and can I change it?”
“How do I route emailed cards to a different list?”
Tell an agent
Send email-to-board cards on board {id} to list {value}.
Make {value} the default email list for board {id}.
PUT /boards/{id}/myPrefs/showSidebar Show or hide the board sidebar · Update showSidebar Pref on a Board #
Ask an LLM
“Can I hide the sidebar on a board for myself?”
“How do I toggle my showSidebar preference?”
Tell an agent
Set sidebar visibility on board {id} to {value}.
Hide the whole sidebar for me on board {id} ({value}).
PUT /boards/{id}/myPrefs/showSidebarActivity Show or hide sidebar activity · Update showSidebarActivity Pref on a Board #
Ask an LLM
“Can I stop the activity feed from showing in a board's sidebar?”
“How do I toggle the showSidebarActivity preference?”
Tell an agent
Set the sidebar activity feed on board {id} to {value}.
Turn off the activity section of the sidebar on board {id} ({value}).
PUT /boards/{id}/myPrefs/showSidebarBoardActions Show or hide sidebar board actions · Update showSidebarBoardActions Pref on a Board #
Ask an LLM
“Can I hide the board actions menu in the sidebar?”
“How do I change the showSidebarBoardActions preference?”
Tell an agent
Set sidebar board actions on board {id} to {value}.
Collapse the board-actions block of the sidebar on board {id} ({value}).
PUT /boards/{id}/myPrefs/showSidebarMembers Show or hide sidebar members · Update showSidebarMembers Pref on a Board #
Ask an LLM
“Can I hide the member avatars in a board's sidebar?”
“How do I toggle showSidebarMembers for a board?”
Tell an agent
Set sidebar members display on board {id} to {value}.
Hide member faces from the sidebar of board {id} ({value}).
POST /boards/ Create a board with Power-Ups or copied content · Create a Board #
Ask an LLM
“Can I create a board that copies another board and keeps its cards?”
“How do I enable Power-Ups on a board at creation time?”
Tell an agent
Copy board {idBoardSource} into a new board {name}, keeping {keepFromSource}.
Create board {name} with Power-Ups {powerUps} enabled.
POST /boards/{id}/calendarKey/generate Generate a board calendar key · Create a calendarKey for a Board #
Ask an LLM
“How do I regenerate the calendar feed key for a board?”
“Can I reset a board's calendar key if the feed URL leaked?”
Tell an agent
Generate a new calendar key for board {id}.
Reset the calendar feed key on board {id}.
POST /boards/{id}/emailKey/generate Generate a board email key · Create a emailKey for a Board #
Ask an LLM
“How do I get a fresh email-to-board address key?”
“Can I rotate a board's email key so old addresses stop working?”
Tell an agent
Generate a new email key for board {id}.
Rotate the email-to-board key on board {id}.
POST /boards/{id}/idTags Add a tag to a board · Create a Tag for a Board #
Ask an LLM
“How do I tag a board so it groups with others in a workspace?”
“Can I attach a tag id to a board?”
Tell an agent
Add tag {value} to board {id}.
Tag board {id} with {value}.
POST /boards/{id}/markAsViewed Mark a board as viewed · Mark Board as viewed #
Ask an LLM
“How do I record that I've viewed a board?”
“Can I mark a board as seen to clear its unread state?”
Tell an agent
Mark board {id} as viewed.
Flag board {id} as seen by me.
GET /boards/{id}/boardPlugins List enabled Power-Ups on a board · Get Enabled Power-Ups on Board #
Ask an LLM
“Which Power-Ups are currently turned on for a board?”
“How do I see a board's enabled Power-Ups only?”
Tell an agent
List the enabled Power-Ups on board {id}.
Show which Power-Ups are switched on for board {id}.
POST /boards/{id}/boardPlugins Enable a Power-Up on a board · Enable a Power-Up on a Board #
Ask an LLM
“How do I turn on a Power-Up for a board?”
“Can an integration enable its own Power-Up on a board?”
Tell an agent
Enable Power-Up {idPlugin} on board {id}.
Switch on plugin {idPlugin} for board {id}.
DELETE /boards/{id}/boardPlugins/{idPlugin} Disable a Power-Up on a board · Disable a Power-Up on a Board #
Ask an LLM
“How do I turn off a Power-Up on a board?”
“Can I disable a Power-Up without removing it from the workspace?”
Tell an agent destructive · confirm first
Disable Power-Up {idPlugin} on board {id}.
Switch off plugin {idPlugin} for board {id}.
GET /boards/{id}/plugins List Power-Ups available on a board · Get Power-Ups on a Board #
Ask an LLM
“What Power-Ups are on a board, enabled or available?”
“Can I filter a board's Power-Up list by status?”
Tell an agent
List the Power-Ups on board {id} filtered by {filter}.
Show all Power-Up plugins associated with board {id}.
POST /boards/{id}/exports Start a board export · Create an Export for a Board #
Ask an LLM
“How do I export a board, including its attachments?”
“Can I run two exports of the same board at once?”
Tell an agent
Start an export of board {id}.
Export board {id} with attachments {attachments}.
GET /boards/{id}/exports/{idExport} Check a board export's status · Get an Export for a Board #
Ask an LLM
“How do I know when a board export has finished?”
“What is the status of an export I started?”
Tell an agent
Check the status of export {idExport} for board {id}.
Is export {idExport} of board {id} ready yet; report its state.
DELETE /boards/{id}/exports/{idExport} Delete a board export · Delete an Export for a Board #
Ask an LLM
“How do I delete an export file I no longer need?”
“Is deleting a board export a hard or soft delete?”
Tell an agent destructive · confirm first
Delete export {idExport} of board {id}.
Discard board {id} export {idExport}.
GET /boards/{id}/exports/{idExport}/download Download a finished board export · Download an Export for a Board #
Ask an LLM
“How do I download the file from a completed board export?”
“What happens if I try to download an export that isn't ready?”
Tell an agent
Download export {idExport} of board {id}.
Grab the exported file {idExport} for board {id}.
GET /boards/{id}/exports/mostRecent Get a board's latest successful export · Get a Board's Most Recent Export #
Ask an LLM
“Where do I find the most recent successful export of a board?”
“Can I get the latest board export without knowing its id?”
Tell an agent
Get the most recent export of board {id}.
Show the latest successful backup export for board {id}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/trello:trello-boards-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

trello-boards-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Trello Boards API
  version: '1.0'
  description: 'Operations tagged Boards across 2 of this provider''s published API definitions: trello-rest-api-openapi.yml, trello-rest-api-swagger-v3.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.trello.com/1
  description: Trello API v1 Production Server
tags:


# --- truncated at 32 KB (83 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/trello/refs/heads/main/openapi/trello-boards-api-openapi.yml