Visual project management and collaboration
developer.atlassian.com/cloud/trello/rest ↗Query structured spec data via REST or MCP. Get exactly what your agent needs.
https://trello.com/1
/actions/{idAction}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idAction | path | required | string | idAction |
Success
Server rejection
DELETE /actions/{idAction}
/boards/{idBoard}/members/{idMember}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idBoard | path | required | string | board_id |
| idMember | path | required | string | idMember |
Success
Server rejection
DELETE /boards/{idBoard}/members/{idMember}
/boards/{idBoard}/powerUps/{powerUp}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idBoard | path | required | string | board_id |
| powerUp | path | required | string | powerUp |
Success
Server rejection
DELETE /boards/{idBoard}/powerUps/{powerUp}
/cards/{idCard}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idCard | path | required | string | card id or shortlink |
Success
Server rejection
DELETE /cards/{idCard}
/cards/{idCard}/actions/{idAction}/comments
This can only be done by the original author of the comment, or someone with higher permissions than the original author.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idCard | path | required | string | card id or shortlink |
| idAction | path | required | string | idAction |
Success
Server rejection
DELETE /cards/{idCard}/actions/{idAction}/comments
/cards/{idCard}/attachments/{idAttachment}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idCard | path | required | string | card id or shortlink |
| idAttachment | path | required | string | idAttachment |
Success
Server rejection
DELETE /cards/{idCard}/attachments/{idAttachment}
/cards/{idCard}/checklist/{idChecklist}/checkItem/{idCheckItem}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idCard | path | required | string | card id or shortlink |
| idChecklist | path | required | string | idChecklist |
| idCheckItem | path | required | string | idCheckItem |
Success
Server rejection
DELETE /cards/{idCard}/checklist/{idChecklist}/checkItem/{idCheckItem}
/cards/{idCard}/checklists/{idChecklist}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idCard | path | required | string | card id or shortlink |
| idChecklist | path | required | string | idChecklist |
Success
Server rejection
DELETE /cards/{idCard}/checklists/{idChecklist}
/cards/{idCard}/idLabels/{idLabel}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idCard | path | required | string | card id or shortlink |
| idLabel | path | required | string | idLabel |
Success
Server rejection
DELETE /cards/{idCard}/idLabels/{idLabel}
/cards/{idCard}/idMembers/{idMember}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idCard | path | required | string | card id or shortlink |
| idMember | path | required | string | idMember |
Success
Server rejection
DELETE /cards/{idCard}/idMembers/{idMember}
/cards/{idCard}/labels/{color}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idCard | path | required | string | card id or shortlink |
| color | path | required | string | color |
Success
Server rejection
DELETE /cards/{idCard}/labels/{color}
/cards/{idCard}/membersVoted/{idMember}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idCard | path | required | string | card id or shortlink |
| idMember | path | required | string | idMember |
Success
Server rejection
DELETE /cards/{idCard}/membersVoted/{idMember}
/cards/{idCard}/stickers/{idSticker}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idCard | path | required | string | card id or shortlink |
| idSticker | path | required | string | idSticker |
Success
Server rejection
DELETE /cards/{idCard}/stickers/{idSticker}
/checklists/{idChecklist}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idChecklist | path | required | string | idChecklist |
Success
Server rejection
DELETE /checklists/{idChecklist}
/checklists/{idChecklist}/checkItems/{idCheckItem}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idChecklist | path | required | string | idChecklist |
| idCheckItem | path | required | string | idCheckItem |
Success
Server rejection
DELETE /checklists/{idChecklist}/checkItems/{idCheckItem}
/labels/{idLabel}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idLabel | path | required | string | idLabel |
Success
Server rejection
DELETE /labels/{idLabel}
/members/{idMember}/boardBackgrounds/{idBoardBackground}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idMember | path | required | string | idMember or username |
| idBoardBackground | path | required | string | idBoardBackground |
Success
Server rejection
DELETE /members/{idMember}/boardBackgrounds/{idBoardBackground}
/members/{idMember}/boardStars/{idBoardStar}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idMember | path | required | string | idMember or username |
| idBoardStar | path | required | string | idBoardStar |
Success
Server rejection
DELETE /members/{idMember}/boardStars/{idBoardStar}
/members/{idMember}/customBoardBackgrounds/{idBoardBackground}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idMember | path | required | string | idMember or username |
| idBoardBackground | path | required | string | idBoardBackground |
Success
Server rejection
DELETE /members/{idMember}/customBoardBackgrounds/{idBoardBackground}
/members/{idMember}/customStickers/{idCustomSticker}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idMember | path | required | string | idMember or username |
| idCustomSticker | path | required | string | idCustomSticker |
Success
Server rejection
DELETE /members/{idMember}/customStickers/{idCustomSticker}
/members/{idMember}/savedSearches/{idSavedSearch}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idMember | path | required | string | idMember or username |
| idSavedSearch | path | required | string | idSavedSearch |
Success
Server rejection
DELETE /members/{idMember}/savedSearches/{idSavedSearch}
/organizations/{idOrg}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idOrg | path | required | string | idOrg or name |
Success
Server rejection
DELETE /organizations/{idOrg}
/organizations/{idOrg}/logo
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idOrg | path | required | string | idOrg or name |
Success
Server rejection
DELETE /organizations/{idOrg}/logo
/organizations/{idOrg}/members/{idMember}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idOrg | path | required | string | idOrg or name |
| idMember | path | required | string | idMember |
Success
Server rejection
DELETE /organizations/{idOrg}/members/{idMember}
/organizations/{idOrg}/members/{idMember}/all
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idOrg | path | required | string | idOrg or name |
| idMember | path | required | string | idMember |
Success
Server rejection
DELETE /organizations/{idOrg}/members/{idMember}/all
/organizations/{idOrg}/prefs/associatedDomain
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idOrg | path | required | string | idOrg or name |
Success
Server rejection
DELETE /organizations/{idOrg}/prefs/associatedDomain
/organizations/{idOrg}/prefs/orgInviteRestrict
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idOrg | path | required | string | idOrg or name |
| value | query | required | string | An email address with optional expansion tokens |
Success
Server rejection
DELETE /organizations/{idOrg}/prefs/orgInviteRestrict
/tokens/{token}
Success
Server rejection
DELETE /tokens/{token}
/tokens/{token}/webhooks/{idWebhook}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idWebhook | path | required | string | idWebhook |
Success
Server rejection
DELETE /tokens/{token}/webhooks/{idWebhook}
/webhooks/{idWebhook}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| idWebhook | path | required | string | idWebhook |
Success
Server rejection
DELETE /webhooks/{idWebhook}
actions
{
"xml": {
"name": "action"
},
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "a string with a length from 1 to 16384"
}
}
}
actions_comments
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "a string with a length from 1 to 16384"
}
}
}
actions_text
{
"xml": {
"name": "action"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "a string with a length from 1 to 16384"
}
}
}
boards
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"desc": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"name": {
"type": "string",
"description": "a string with a length from 1 to 16384"
},
"closed": {
"type": "string",
"description": " true or false"
},
"powerUps": {
"type": "string",
"description": "all or a comma-separated list of: calendar, cardAging, recap or voting"
},
"subscribed": {
"type": "string",
"description": " true or false"
},
"prefs/voting": {
"type": "string",
"description": "One of: disabled, members, observers, org or public"
},
"prefs_voting": {
"type": "string",
"description": "One of: disabled, members, observers, org or public"
},
"idBoardSource": {
"type": "string",
"description": "The id of the board to copy into the new board"
},
"idOrganization": {
"type": "string",
"description": "The id or name of the organization to add the board to."
},
"keepFromSource": {
"type": "string",
"description": "Components of the source board to copy."
},
"labelNames/red": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"prefs/comments": {
"type": "string",
"description": "One of: disabled, members, observers, org or public"
},
"prefs/selfJoin": {
"type": "string",
"description": " true or false"
},
"prefs_comments": {
"type": "string",
"description": "One of: disabled, members, observers, org or public"
},
"prefs_selfJoin": {
"type": "string",
"description": " true or false"
},
"labelNames/blue": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"prefs/cardAging": {
"type": "string",
"description": "One of: pirate or regular"
},
"prefs_cardAging": {
"type": "string",
"description": "One of: pirate or regular"
},
"labelNames/green": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"prefs/background": {
"type": "string",
"description": "A standard background name, or the id of a custom background"
},
"prefs/cardCovers": {
"type": "string",
"description": " true or false"
},
"prefs_background": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"prefs_cardCovers": {
"type": "string",
"description": " true or false"
},
"labelNames/orange": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"labelNames/purple": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"labelNames/yellow": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"prefs/invitations": {
"type": "string",
"description": "One of: admins or members"
},
"prefs_invitations": {
"type": "string",
"description": "One of: admins or members"
},
"prefs/permissionLevel": {
"type": "string",
"description": "One of: org, private or public"
},
"prefs_permissionLevel": {
"type": "string",
"description": "One of: org, private or public"
},
"prefs/calendarFeedEnabled": {
"type": "string",
"description": " true or false"
}
}
}
boards_checklists
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "a string with a length from 1 to 16384"
}
}
}
boards_closed
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": " true or false"
}
}
}
boards_desc
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "a string with a length from 0 to 16384"
}
}
}
boards_idOrganization
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "a string with a length from 0 to 16384"
}
}
}
boards_labels
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"color": {
"type": "string",
"description": "A valid label color or null"
}
}
}
boards_lists
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"pos": {
"type": "string",
"description": "A position. top , bottom , or a positive number."
},
"name": {
"type": "string",
"description": "a string with a length from 1 to 16384"
}
}
}
boards_members
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "One of: admin, normal or observer"
},
"email": {
"type": "string",
"description": "An email address"
},
"fullName": {
"type": "string",
"description": "A string with a length of at least 1. Cannot begin or end with a space."
}
}
}
boards_memberships
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "One of: admin, normal or observer"
},
"member_fields": {
"type": "string",
"description": "all or a comma-separated list of: avatarHash, bio, bioData, confirmed, fullName, idPremOrgsAdmin, initials, memberType, products, status, url or username"
}
}
}
boards_name
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "a string with a length from 1 to 16384"
}
}
}
boards_powerUps
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "One of: calendar, cardAging, recap or voting"
}
}
}
boards_subscribed
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": " true or false"
}
}
}
cards
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"due": {
"type": "string",
"description": "A date, or null"
},
"pos": {
"type": "string",
"description": "A position. top , bottom , or a positive number."
},
"desc": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"name": {
"type": "string",
"description": "The name of the new card. It isn't required if the name is being copied from provided by a URL, file or card that is being copied."
},
"closed": {
"type": "string",
"description": " true or false"
},
"idList": {
"type": "string",
"description": "id of the list that the card should be added to"
},
"labels": {
"type": "string",
"description": "all or a comma-separated list of: blue, green, orange, purple, red or yellow"
},
"idBoard": {
"type": "string",
"description": "id of the board the card should be moved to"
},
"idLabels": {
"type": "string",
"description": "A comma-separated list of objectIds, 24-character hex strings"
},
"idMembers": {
"type": "string",
"description": "A comma-separated list of objectIds, 24-character hex strings"
},
"urlSource": {
"type": "string",
"description": "A URL starting with http:// or https:// or null"
},
"fileSource": {
"type": "string",
"description": "A file"
},
"subscribed": {
"type": "string",
"description": " true or false"
},
"idCardSource": {
"type": "string",
"description": "The id of the card to copy into a new card."
},
"keepFromSource": {
"type": "string",
"description": "Properties of the card to copy over from the source."
},
"idAttachmentCover": {
"type": "string",
"description": "Id of the image attachment of this card to use as its cover, or null for no cover"
}
}
}
cards_actions_comments
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "a string with a length from 1 to 16384"
}
}
}
cards_attachments
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "A URL starting with http:// or https:// or null"
},
"file": {
"type": "string",
"description": "A file"
},
"name": {
"type": "string",
"description": "a string with a length from 0 to 256"
},
"mimeType": {
"type": "string",
"description": "a string with a length from 0 to 256"
}
}
}
cards_checklist_checkItem
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"pos": {
"type": "string",
"description": "A position. top , bottom , or a positive number."
},
"name": {
"type": "string",
"description": "a string with a length from 1 to 16384"
}
}
}
cards_checklist_checkItem_name
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "a string with a length from 1 to 16384"
}
}
}
cards_checklist_checkItem_pos
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "A position. top , bottom , or a positive number."
}
}
}
cards_checklist_checkItem_state
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "One of: complete, false, incomplete or true"
}
}
}
cards_checklist_idChecklistCurrent_checkItem
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"pos": {
"type": "string",
"description": "A position. top , bottom , or a positive number."
},
"name": {
"type": "string",
"description": "a string with a length from 1 to 16384"
},
"state": {
"type": "string",
"description": "One of: complete, false, incomplete or true"
},
"idChecklist": {
"type": "string",
"description": "An id, or null"
}
}
}
cards_checklists
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"value": {
"type": "string",
"description": "The id of the checklist to add to the card, or null to create a new one."
},
"idChecklistSource": {
"type": "string",
"description": "The id of the source checklist to copy into a new checklist."
}
}
}
cards_closed
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": " true or false"
}
}
}
cards_desc
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "a string with a length from 0 to 16384"
}
}
}
cards_due
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "A date, or null"
}
}
}
cards_idAttachmentCover
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "Id of the image attachment of this card to use as its cover, or null for no cover"
}
}
}
cards_idBoard
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "id of the board the card should be moved to"
},
"idList": {
"type": "string",
"description": "id of the list that the card should be moved to on the new board"
}
}
}
cards_idLabels
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The id of the label to add"
}
}
}
cards_idList
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "id of the list the card should be moved to"
}
}
}
cards_idMembers
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The id of the member to add to the card"
}
}
}
cards_labels
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"color": {
"type": "string",
"description": "A valid label color or null"
},
"value": {
"type": "string",
"description": "all or a comma-separated list of: blue, green, orange, purple, red or yellow"
}
}
}
cards_membersVoted
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The id of the member to vote 'yes' on the card"
}
}
}
cards_name
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "a string with a length from 1 to 16384"
}
}
}
cards_pos
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "A position. top , bottom , or a positive number."
}
}
}
cards_stickers
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"top": {
"type": "string",
"description": "undefined"
},
"left": {
"type": "string",
"description": "undefined"
},
"image": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"rotate": {
"type": "string",
"description": "undefined"
},
"zIndex": {
"type": "string",
"description": "Valid Z values for stickers, must be an integer"
}
}
}
cards_subscribed
{
"xml": {
"name": "card"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": " true or false"
}
}
}
checklists
{
"xml": {
"name": "checklist"
},
"type": "object",
"properties": {
"pos": {
"type": "string",
"description": "A position. top , bottom , or a positive number."
},
"name": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"idCard": {
"type": "string",
"description": "id of the card that the checklist should be added to"
},
"idBoard": {
"type": "string",
"description": "id of the board that the checklist should be added to"
},
"idChecklistSource": {
"type": "string",
"description": "The id of the source checklist to copy into a new checklist."
}
}
}
checklists_checkItems
{
"xml": {
"name": "checklist"
},
"type": "object",
"properties": {
"pos": {
"type": "string",
"description": "A position. top , bottom , or a positive number."
},
"name": {
"type": "string",
"description": "a string with a length from 1 to 16384"
},
"checked": {
"type": "string",
"description": " true or false"
}
}
}
checklists_idCard
{
"xml": {
"name": "checklist"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The id of the card that the checklist is on"
}
}
}
checklists_name
{
"xml": {
"name": "checklist"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "a string with a length from 1 to 16384"
}
}
}
checklists_pos
{
"xml": {
"name": "checklist"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "A position. top , bottom , or a positive number."
}
}
}
labelNames_blue
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "a string with a length from 0 to 16384"
}
}
}
labelNames_green
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "a string with a length from 0 to 16384"
}
}
}
labelNames_orange
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "a string with a length from 0 to 16384"
}
}
}
labelNames_purple
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "a string with a length from 0 to 16384"
}
}
}
labelNames_red
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "a string with a length from 0 to 16384"
}
}
}
labelNames_yellow
{
"xml": {
"name": "board"
},
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "a string with a length from 0 to 16384"
}
}
}
labels
{
"xml": {
"name": "label"
},
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "a string with a length from 0 to 16384"
},
"color": {
"type": "string",
"description": "A valid label color or null"
},
"idBoard": {
"type": "string",
"description": "An id"
}
}
}
| Version | Endpoints | Schemas | Ingested | Status |
|---|---|---|---|---|
| 1.0 | 323 | 122 | 2026-05-11 | current |
| 1.0 | 323 | 122 | 2026-04-16 |