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 Cards API

Operations for creating, retrieving, updating, and deleting cards, including managing card attachments, checklists, comments, labels, members, and stickers.

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

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

This API exposes 45 operations across 32 paths, and defines 22 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.

45 operations 32 paths 22 schemas 11 DELETE16 GET11 POST7 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 Cards 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 45

Across 32 paths, the API surfaces 45 operations — 11 DELETE, 16 GET, 11 POST, 7 PUT. Each is listed below with its method, path, parameters, and response codes.

Cards 45

Operations for creating, retrieving, updating, and deleting cards, including managing card attachments, checklists, comments, labels, members, and stickers.

POST
/cards
Create a Card
createCard 11 params → 200400401
GET
/cards/{id}
Get a Card
getCard 8 params → 200401404
PUT
/cards/{id}
Update a Card
updateCard 15 params → 200401404
DELETE
/cards/{id}
Delete a Card
deleteCard 2 params → 200401404
GET
/cards/{id}/actions
Get Actions on a Card
getCardActions 2 params → 200401404
POST
/cards/{id}/actions/comments
Add a Comment to a Card
createCardComment 2 params → 200401404
GET
/cards/{id}/attachments
Get Attachments on a Card
getCardAttachments 3 params → 200401404
POST
/cards/{id}/attachments
Create an Attachment on a Card
createCardAttachment 5 params → 200401404
GET
/cards/{id}/checklists
Get Checklists on a Card
getCardChecklists 1 param → 200401404
POST
/cards/{id}/checklists
Create a Checklist on a Card
createCardChecklist 4 params → 200401404
POST
/cards/{id}/labels
Add a Label to a Card
addCardLabel 2 params → 200401404
DELETE
/cards/{id}/labels/{idLabel}
Remove a Label from a Card
removeCardLabel 2 params → 200401404
POST
/cards/{id}/members
Add a Member to a Card
addCardMember 2 params → 200401404
GET
/cards/{id}/members
Get the Members of a Card
get-cards-id-members 2 params → 200
DELETE
/cards/{id}/members/{idMember}
Remove a Member from a Card
removeCardMember 2 params → 200401404
GET
/cards/{id}/stickers
Get Stickers on a Card
getCardStickers 2 params → 200401404
POST
/cards/{id}/stickers
Add a Sticker to a Card
addCardSticker 7 params → 200401404
GET
/cards/{id}/{field}
Get a field on a Card
get-cards-id-field 2 params → 200
GET
/cards/{id}/attachments/{idAttachment}
Get an Attachment on a Card
get-cards-id-attachments-idattachment 3 params → 200
DELETE
/cards/{id}/attachments/{idAttachment}
Delete an Attachment on a Card
deleted-cards-id-attachments-idattachment 4 params → 200
GET
/cards/{id}/board
Get the Board the Card is on
get-cards-id-board 2 params → 200
GET
/cards/{id}/checkItemStates
Get checkItems on a Card
get-cards-id-checkitemstates 2 params → 200
GET
/cards/{id}/checkItem/{idCheckItem}
Get checkItem on a Card
get-cards-id-checkitem-idcheckitem 3 params → 200
PUT
/cards/{id}/checkItem/{idCheckItem}
Update a checkItem on a Card
put-cards-id-checkitem-idcheckitem 9 params → 200
DELETE
/cards/{id}/checkItem/{idCheckItem}
Delete checkItem on a Card
delete-cards-id-checkitem-idcheckitem 2 params → 200
GET
/cards/{id}/list
Get the List of a Card
get-cards-id-list 2 params → 200
GET
/cards/{id}/membersVoted
Get Members who have voted on a Card
get-cards-id-membersvoted 2 params → 200
POST
/cards/{id}/membersVoted
Add Member vote to Card
cardsidmembersvoted-1 2 params → 200
GET
/cards/{id}/pluginData
Get pluginData on a Card
get-cards-id-plugindata 1 param → 200
GET
/cards/{id}/stickers/{idSticker}
Get a Sticker on a Card
get-cards-id-stickers-idsticker 3 params → 200
DELETE
/cards/{id}/stickers/{idSticker}
Delete a Sticker on a Card
delete-cards-id-stickers-idsticker 2 params → 200
PUT
/cards/{id}/stickers/{idSticker}
Update a Sticker on a Card
put-cards-id-stickers-idsticker 6 params → 200
PUT
/cards/{id}/actions/{idAction}/comments
Update Comment Action on a Card
put-cards-id-actions-idaction-comments 3 params → 200
DELETE
/cards/{id}/actions/{idAction}/comments
Delete a comment on a Card
delete-cards-id-actions-id-comments 2 params → 200
PUT
/cards/{idCard}/customField/{idCustomField}/item
Update Custom Field item on Card
put-cards-idcard-customfield-idcustomfield-item 2 params body → 200
PUT
/cards/{idCard}/customFields
Update Multiple Custom Field items on Card
put-cards-idcard-customfields body → 200
GET
/cards/{id}/customFieldItems
Get Custom Field Items for a Card
get-cards-id-customfielditems 1 param → 200
POST
/cards/{id}/idLabels
Add a Label to a Card
post-cards-id-idlabels 2 params → 200
POST
/cards/{id}/idMembers
Add a Member to a Card
post-cards-id-idmembers 2 params → 200
POST
/cards/{id}/markAssociatedNotificationsRead
Mark a Card's Notifications as read
post-cards-id-markassociatednotificationsread 1 param → 200
DELETE
/cards/{id}/idLabels/{idLabel}
Remove a Label from a Card
delete-cards-id-idlabels-idlabel 2 params → 200
DELETE
/cards/{id}/idMembers/{idMember}
Remove a Member from a Card
delete-id-idmembers-idmember 2 params → 200
DELETE
/cards/{id}/membersVoted/{idMember}
Remove a Member's Vote on a Card
delete-cards-id-membersvoted-idmember 2 params → 200
PUT
/cards/{idCard}/checklist/{idChecklist}/checkItem/{idCheckItem}
Update Checkitem on Checklist on Card
put-cards-idcard-checklist-idchecklist-checkitem-idcheckitem 4 params → 200
DELETE
/cards/{id}/checklists/{idChecklist}
Delete a Checklist on a Card
delete-cards-id-checklists-idchecklist 2 params → 200

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are Card_2 (33 properties), Card (23 properties), Member (13 properties), Attachment_2 (11 properties). Each schema is shown below with its type and property counts.

Attachment
object
Represents a file or URL attachment on a card.
10 properties
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
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
Sticker
object
Represents a decorative sticker placed on a card.
7 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
Checklist
object
Represents a checklist on a card, containing a list of check items that can be marked as complete or incomplete.
6 properties
LimitsObject
object
3 properties
Attachment_2
object
11 properties
Card_2
object
33 properties
Limits
object
1 property
Label_2
object
4 properties
Checklist_2
object
1 property
Color
stringnull
CheckItem_2
object
6 properties
AttachmentFields
string
Action_2
object
8 properties
CardFields
string
The fields on a Card.
TrelloID
string
CustomFieldItems
object
5 properties
posStringOrNumber

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

trello-cards-api-openapi.yml Raw ↑

Other APIs Trello publishes across the network.

Trello Webhooks API
Trello Power-Ups
trello Actions API
trello Boards 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 Cards 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.