How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

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.

trello Boards API is one of 20 APIs that Trello publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Boards. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 43 operations across 35 paths, and defines 28 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against a single base URL, https://api.trello.com/1.

43 operations 35 paths 28 schemas 4 DELETE19 GET10 POST10 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.trello.com
Authentication
API Key, API Key, API Key, API Key, OAuth 2.0
Resource Areas
1

Authentication & Security 5

trello Boards API declares 5 security schemes for authenticating requests. An API key is passed in the query as key (apiKey). An API key is passed in the query as token (apiToken). An API key is passed in the query as key (APIKey). An API key is passed in the query as token (APIToken). It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 10 scopes.

  • apiKey — Your Trello API key, obtained from the Power-Ups admin page at https://trello.com/power-ups/admin.
  • apiToken — A user token that grants access to Trello resources. Obtained by authorizing via the /1/authorize route or OAuth 1.0.

Paths & Operations 43

Across 35 paths, the API surfaces 43 operations — 4 DELETE, 19 GET, 10 POST, 10 PUT. Each is listed below with its method, path, parameters, and response codes.

Boards 43

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

POST
/boards
Create a Board
createBoard 12 params → 200400401
GET
/boards/{id}
Get a Board
getBoard 13 params → 200401404
PUT
/boards/{id}
Update a Board
updateBoard 19 params → 200401404
DELETE
/boards/{id}
Delete a Board
deleteBoard 2 params → 200401404
GET
/boards/{id}/actions
Get Actions for a Board
getBoardActions 3 params → 200401404
GET
/boards/{id}/cards
Get Cards on a Board
getBoardCards 2 params → 200401404
GET
/boards/{id}/cards/{filter}
Get Filtered Cards on a Board
getBoardCardsFilter 2 params → 200401404
GET
/boards/{id}/checklists
Get Checklists on a Board
getBoardChecklists 1 param → 200401404
GET
/boards/{id}/labels
Get Labels on a Board
getBoardLabels 3 params → 200401404
POST
/boards/{id}/labels
Create a Label on a Board
createBoardLabel 3 params → 200400401404
GET
/boards/{id}/lists
Get Lists on a Board
getBoardLists 6 params → 200401404
POST
/boards/{id}/lists
Create a List on a Board
createBoardList 4 params → 200400401404
GET
/boards/{id}/members
Get Members of a Board
getBoardMembers 2 params → 200401404
PUT
/boards/{id}/members
Invite a Member to a Board
inviteBoardMember 4 params → 200401404
PUT
/boards/{id}/members/{idMember}
Update a Board Member
updateBoardMember 5 params → 200401404
DELETE
/boards/{id}/members/{idMember}
Remove a Member from a Board
removeBoardMember 4 params → 200401404
GET
/boards/{id}/memberships
Get Memberships of a Board
getBoardMemberships 2 params → 200401404
GET
/boards/{id}/{field}
Get a field on a Board
get-boards-id-field 2 params → 200
GET
/boards/{boardId}/actions
Get Actions of a Board
get-boards-id-actions 14 params → 200
GET
/boards/{boardId}/boardStars
Get boardStars on a Board
get-boards-id-boardstars 2 params → 200
GET
/boards/{id}/customFields
Get Custom Fields for Board
get-boards-id-customfields 1 param → 200
GET
/boards/{id}/lists/{filter}
Get filtered Lists on a Board
get-boards-id-lists-filter 2 params → 200
PUT
/boards/{id}/memberships/{idMembership}
Update Membership of Member on a Board
put-boards-id-memberships-idmembership 4 params → 200
PUT
/boards/{id}/myPrefs/emailPosition
Update emailPosition Pref on a Board
put-boards-id-myprefs-emailposition 2 params → 200
PUT
/boards/{id}/myPrefs/idEmailList
Update idEmailList Pref on a Board
put-boards-id-myprefs-idemaillist 2 params → 200
PUT
/boards/{id}/myPrefs/showSidebar
Update showSidebar Pref on a Board
put-boards-id-myPrefs-showsidebar 2 params → 200
PUT
/boards/{id}/myPrefs/showSidebarActivity
Update showSidebarActivity Pref on a Board
put-boards-id-myPrefs-showsidebaractivity 2 params → 200
PUT
/boards/{id}/myPrefs/showSidebarBoardActions
Update showSidebarBoardActions Pref on a Board
put-boards-id-myPrefs-showsidebarboardactions 2 params → 200
PUT
/boards/{id}/myPrefs/showSidebarMembers
Update showSidebarMembers Pref on a Board
put-boards-id-myPrefs-showsidebarmembers 2 params → 200
POST
/boards/
Create a Board
post-boards 16 params → 200
POST
/boards/{id}/calendarKey/generate
Create a calendarKey for a Board
post-boards-id-calendarkey-generate 1 param → 200
POST
/boards/{id}/emailKey/generate
Create a emailKey for a Board
post-boards-id-emailkey-generate 1 param → 200
POST
/boards/{id}/idTags
Create a Tag for a Board
post-boards-id-idtags 2 params → 200
POST
/boards/{id}/markAsViewed
Mark Board as viewed
post-boards-id-markedasviewed 1 param → 200
GET
/boards/{id}/boardPlugins
Get Enabled Power-Ups on Board
get-boards-id-boardplugins 1 param → 200
POST
/boards/{id}/boardPluginsdeprecated
Enable a Power-Up on a Board
post-boards-id-boardplugins 2 params → 200
DELETE
/boards/{id}/boardPlugins/{idPlugin}deprecated
Disable a Power-Up on a Board
delete-boards-id-boardplugins 2 params → 200
GET
/boards/{id}/plugins
Get Power-Ups on a Board
get-board-id-plugins 2 params → 200
POST
/boards/{id}/exports
Create an Export for a Board
post-boards-id-exports 3 params → 200
GET
/boards/{id}/exports/{idExport}
Get an Export for a Board
get-boards-id-exports-idexport 2 params → 200
DELETE
/boards/{id}/exports/{idExport}
Delete an Export for a Board
delete-boards-id-exports-idexport 2 params → 200
GET
/boards/{id}/exports/{idExport}/download
Download an Export for a Board
get-boards-id-exports-idexport-download 2 params → 302400
GET
/boards/{id}/exports/mostRecent
Get a Board's Most Recent Export
get-boards-id-exports-mostrecent 1 param → 200404

Schemas 28

The contract defines 28 schemas that model the data the API accepts and returns. The most detailed are Board_2 (26 properties), Card (23 properties), Prefs (22 properties), Board (17 properties). Each schema is shown below with its type and property counts.

Card
object
Represents a Trello card, which is the fundamental unit of work on a board. Cards live within lists and can have members, labels, checklists, attachments, due…
23 properties
Label
object
Represents a color-coded label that can be applied to cards for categorization and filtering.
4 properties
TrelloList
object
Represents a list on a Trello board. Lists are vertical columns that contain cards and represent stages in a workflow.
7 properties
CheckItem
object
Represents a single item in a checklist that can be checked or unchecked.
7 properties
Member
object
Represents a Trello user who can be a member of boards, organizations, and cards.
13 properties
Membership
object
Represents a membership record linking a member to a board or organization with a specific role.
5 properties
Action
object
Represents an activity event that occurred on a Trello object, such as creating a card, adding a comment, or moving a card between lists.
7 properties
Board
object
Represents a Trello board, which is the primary organizational unit containing lists and cards.
17 properties
Checklist
object
Represents a checklist on a card, containing a list of check items that can be marked as complete or incomplete.
6 properties
Plugin
object
1 property
MemberFields
string
TrelloList_2
object
8 properties
Color
stringnull
Prefs
object
22 properties
LimitsObject
object
3 properties
CustomField
object
6 properties
Error
object
2 properties 2 required
Label_2
object
4 properties
TrelloID
string
Limits
object
1 property
BoardStars
object
3 properties
CardAging
string
ImageDescriptor
object
3 properties
Board_2
object
26 properties 1 required
ViewFilter
string
Export
object
5 properties
Action_2
object
8 properties
Memberships
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

trello-boards-api-openapi.yml Raw ↑

Other APIs Trello publishes across the network.

Trello Webhooks API
Trello Power-Ups
trello Actions API
trello Cards API
trello Checklists API
trello Labels API
trello Lists API
trello Members API
trello Notifications API
trello Organizations API
trello Plugins API
trello Search API
Where this information came from

This is an independent, third-party profile of trello Boards API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.