# Trello REST API

**Canonical:** https://apis.io/apis/trello/trello-rest-api/  
**Provider:** Trello — https://apis.io/providers/trello/  
**Base URL:** https://api.trello.com/1  
**Documentation:** https://developer.atlassian.com/cloud/trello/rest/

Trello REST API is one of 17 APIs that [Trello](https://apis.io/providers/trello/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Project Management, Kanban, Task Management, Collaboration, and Productivity. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

The complete first-party Trello REST API v1, as published by Atlassian at https://developer.atlassian.com/cloud/trello/swagger.v3.json. OpenAPI 3.0.0, 191 paths, 261 operations and 63 schemas covering boards, lists, cards, checklists, labels, custom fields, attachments, members, workspaces, enterprises, actions, notifications, search, webhooks, tokens, Power-Up plugins, emoji and batch requests. Every operation carries an operationId and a summary. Authorization is an API key plus user token passed as query parameters, or OAuth 2.0 3LO (GA 15 September 2026) with ten granular scopes.

## Operations (60 of 261)

| Method | Path | Summary |
|---|---|---|
| GET | `/actions/{id}` | Get an Action |
| PUT | `/actions/{id}` | Update an Action |
| DELETE | `/actions/{id}` | Delete an Action |
| GET | `/actions/{id}/{field}` | Get a specific field on an Action |
| GET | `/actions/{id}/board` | Get the Board for an Action |
| GET | `/actions/{id}/card` | Get the Card for an Action |
| GET | `/actions/{id}/list` | Get the List for an Action |
| GET | `/actions/{id}/member` | Get the Member of an Action |
| GET | `/actions/{id}/memberCreator` | Get the Member Creator of an Action |
| GET | `/actions/{id}/organization` | Get the Organization of an Action |
| PUT | `/actions/{id}/text` | Update a Comment Action |
| GET | `/actions/{idAction}/reactions` | Get Action's Reactions |
| POST | `/actions/{idAction}/reactions` | Create Reaction for Action |
| GET | `/actions/{idAction}/reactions/{id}` | Get Action's Reaction |
| DELETE | `/actions/{idAction}/reactions/{id}` | Delete Action's Reaction |
| GET | `/actions/{idAction}/reactionsSummary` | List Action's summary of Reactions |
| GET | `/applications/{key}/compliance` | Get Application's compliance data |
| GET | `/batch` | Batch Requests |
| GET | `/boards/{id}/memberships` | Get Memberships of a Board |
| GET | `/boards/{id}` | Get a Board |
| PUT | `/boards/{id}` | Update a Board |
| DELETE | `/boards/{id}` | Delete a Board |
| GET | `/boards/{id}/{field}` | Get a field on a Board |
| GET | `/boards/{boardId}/actions` | Get Actions of a Board |
| GET | `/boards/{boardId}/boardStars` | Get boardStars on a Board |
| GET | `/boards/{id}/checklists` | Get Checklists on a Board |
| GET | `/boards/{id}/cards` | Get Cards on a Board |
| GET | `/boards/{id}/cards/{filter}` | Get filtered Cards on a Board |
| GET | `/boards/{id}/customFields` | Get Custom Fields for Board |
| GET | `/boards/{id}/labels` | Get Labels on a Board |
| POST | `/boards/{id}/labels` | Create a Label on a Board |
| GET | `/boards/{id}/lists` | Get Lists on a Board |
| POST | `/boards/{id}/lists` | Create a List on a Board |
| GET | `/boards/{id}/lists/{filter}` | Get filtered Lists on a Board |
| GET | `/boards/{id}/members` | Get the Members of a Board |
| PUT | `/boards/{id}/members` | Invite Member to Board via email |
| PUT | `/boards/{id}/members/{idMember}` | Add a Member to a Board |
| DELETE | `/boards/{id}/members/{idMember}` | Remove Member from Board |
| PUT | `/boards/{id}/memberships/{idMembership}` | Update Membership of Member on a Board |
| PUT | `/boards/{id}/myPrefs/emailPosition` | Update emailPosition Pref on a Board |
| PUT | `/boards/{id}/myPrefs/idEmailList` | Update idEmailList Pref on a Board |
| PUT | `/boards/{id}/myPrefs/showSidebar` | Update showSidebar Pref on a Board |
| PUT | `/boards/{id}/myPrefs/showSidebarActivity` | Update showSidebarActivity Pref on a Board |
| PUT | `/boards/{id}/myPrefs/showSidebarBoardActions` | Update showSidebarBoardActions Pref on a Board |
| PUT | `/boards/{id}/myPrefs/showSidebarMembers` | Update showSidebarMembers Pref on a Board |
| POST | `/boards/` | Create a Board |
| POST | `/boards/{id}/calendarKey/generate` | Create a calendarKey for a Board |
| POST | `/boards/{id}/emailKey/generate` | Create a emailKey for a Board |
| POST | `/boards/{id}/idTags` | Create a Tag for a Board |
| POST | `/boards/{id}/markAsViewed` | Mark Board as viewed |
| GET | `/boards/{id}/boardPlugins` | Get Enabled Power-Ups on Board |
| POST | `/boards/{id}/boardPlugins` | Enable a Power-Up on a Board |
| DELETE | `/boards/{id}/boardPlugins/{idPlugin}` | Disable a Power-Up on a Board |
| GET | `/boards/{id}/plugins` | Get Power-Ups on a Board |
| POST | `/boards/{id}/exports` | Create an Export for a Board |
| GET | `/boards/{id}/exports/{idExport}` | Get an Export for a Board |
| DELETE | `/boards/{id}/exports/{idExport}` | Delete an Export for a Board |
| GET | `/boards/{id}/exports/{idExport}/download` | Download an Export for a Board |
| GET | `/boards/{id}/exports/mostRecent` | Get a Board's Most Recent Export |
| POST | `/cards` | Create a new Card |

…and 201 more operations. The page lists the first 250; the full set of 261 is in the OpenAPI linked below.

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/trello/refs/heads/main/openapi/trello-rest-api-openapi.json
- **OpenAPI** — https://developer.atlassian.com/cloud/trello/swagger.v3.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/trello/refs/heads/main/overlays/trello-rest-api-overlay.yaml
- **Documentation** — https://developer.atlassian.com/cloud/trello/rest/
- **APIReference** — https://developer.atlassian.com/cloud/trello/rest/
- **GettingStarted** — https://developer.atlassian.com/cloud/trello/guides/rest-api/api-introduction/
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/trello/refs/heads/main/data-model/trello-data-model.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/trello/refs/heads/main/errors/trello-problem-types.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/trello/refs/heads/main/conventions/trello-conventions.yml

## Other Trello APIs (12)

- [Trello Webhooks API](https://apis.io/apis/trello/webhooks-api/)
- [Trello Power-Ups](https://apis.io/apis/trello/power-ups/)
- [trello Actions API](https://apis.io/apis/trello/trello-actions-api/)
- [trello Boards API](https://apis.io/apis/trello/trello-boards-api/)
- [trello Cards API](https://apis.io/apis/trello/trello-cards-api/)
- [trello Checklists API](https://apis.io/apis/trello/trello-checklists-api/)
- [trello Labels API](https://apis.io/apis/trello/trello-labels-api/)
- [trello Lists API](https://apis.io/apis/trello/trello-lists-api/)
- [trello Members API](https://apis.io/apis/trello/trello-members-api/)
- [trello Notifications API](https://apis.io/apis/trello/trello-notifications-api/)
- [trello Organizations API](https://apis.io/apis/trello/trello-organizations-api/)
- [trello Plugins API](https://apis.io/apis/trello/trello-plugins-api/)

## Tags

Project Management, Kanban, Task Management, Collaboration, Productivity

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/trello/trello-rest-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/trello/.
