• Actions
    • Applications
    • Batch
    • Boards
    • Cards
    • Checklists
    • CustomFields
    • Emoji
    • Enterprises
    • Labels
    • Lists
    • Members
    • Notifications
    • Organizations
    • Plugins
    • Tokens
    • Webhooks
    Cloud
    Trello / Reference / REST API

    Rate this page:

    Actions

    Postman Collection
    OpenAPI
    GET

    Get an Action

    Get an Action

    Request

    Path parameters

    id

    TrelloID

    Required

    Query parameters

    display

    boolean

    entities

    boolean

    fields

    string

    member

    boolean

    member_fields

    string

    memberCreator

    boolean

    memberCreator_fields

    string

    Responses

    Success

    GET/actions/{id}
    1 2 curl --request GET \ --url 'https://api.trello.com/1/actions/{id}?key=APIKey&token=APIToken'
    PUT

    Update an Action

    Update a specific Action. Only comment actions can be updated. Used to edit the content of a comment.

    Request

    Path parameters

    id

    TrelloID

    Required

    Query parameters

    text

    string

    Required

    Responses

    Success

    PUT/actions/{id}
    1 2 curl --request PUT \ --url 'https://api.trello.com/1/actions/{id}?text={text}&key=APIKey&token=APIToken'
    DEL

    Delete an Action

    Delete a specific action. Only comment actions can be deleted.

    Request

    Path parameters

    id

    TrelloID

    Required

    Responses

    Success

    DEL/actions/{id}
    1 2 curl --request DELETE \ --url 'https://api.trello.com/1/actions/{id}?key=APIKey&token=APIToken'
    GET

    Get a specific field on an Action

    Get a specific property of an action

    Request

    Path parameters

    id

    TrelloID

    Required
    field

    ActionFields

    Required

    Responses

    Success

    application/json

    Action
    GET/actions/{id}/{field}
    1 2 3 curl --request GET \ --url 'https://api.trello.com/1/actions/{id}/{field}?key=APIKey&token=APIToken' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 { "id": "5abbe4b7ddc1b351ef961414", "idMemberCreator": "5abbe4b7ddc1b351ef961414", "data": { "text": "Can never go wrong with bowie", "card": { "id": "5abbe4b7ddc1b351ef961414", "name": "Bowie", "idShort": 7, "shortLink": "3CsPkqOF" }, "board": { "id": "5abbe4b7ddc1b351ef961414", "name": "Mullets", "shortLink": "3CsPkqOF" }, "list": { "id": "5abbe4b7ddc1b351ef961414", "name": "Amazing" } }, "type": "commentCard", "date": "2020-03-09T19:41:51.396Z", "limits": { "reactions": { "perAction": { "status": "ok", "disableAt": 1000, "warnAt": 900 }, "uniquePerAction": { "status": "ok", "disableAt": 1000, "warnAt": 900 } } }, "display": { "translationKey": "action_comment_on_card", "entities": { "contextOn": { "type": "translatable", "translationKey": "action_on", "hideIfContext": true, "idContext": "5abbe4b7ddc1b351ef961414" }, "card": { "type": "card", "hideIfContext": true, "id": "5abbe4b7ddc1b351ef961414", "shortLink": "3CsPkqOF", "text": "Bowie" }, "comment": { "type": "comment", "text": "Can never go wrong with bowie" }, "memberCreator": { "type": "member", "id": "5abbe4b7ddc1b351ef961414", "username": "bobloblaw", "text": "Bob Loblaw (World)" } } }, "memberCreator": { "id": "5abbe4b7ddc1b351ef961414", "activityBlocked": false, "avatarHash": "db2adf80c2e6c26b76e1f10400eb4c45", "avatarUrl": "https://trello-members.s3.amazonaws.com/5b02e7f4e1facdc393169f9d/db2adf80c2e6c26b76e1f10400eb4c45", "fullName": "Bob Loblaw (Trello)", "idMemberReferrer": "5abbe4b7ddc1b351ef961414", "initials": "BL", "username": "bobloblaw" } }
    GET

    Get the Board for an Action

    Get the Board for an Action

    Request

    Path parameters

    id

    TrelloID

    Required

    Query parameters

    fields

    BoardFields

    Responses

    Success

    application/json

    Board
    GET/actions/{id}/board
    1 2 3 curl --request GET \ --url 'https://api.trello.com/1/actions/{id}/board?key=APIKey&token=APIToken' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 { "id": "5abbe4b7ddc1b351ef961414", "name": "Trello Platform Changes", "desc": "Track changes to Trello's Platform on this board.", "descData": "<string>", "closed": false, "idMemberCreator": "5abbe4b7ddc1b351ef961414", "idOrganization": "5abbe4b7ddc1b351ef961414", "pinned": false, "url": "https://trello.com/b/dQHqCohZ/trello-platform-changelog", "shortUrl": "https://trello.com/b/dQHqCohZ", "prefs": { "permissionLevel": "org", "hideVotes": true, "voting": "disabled", "comments": "<string>", "selfJoin": true, "cardCovers": true, "isTemplate": true, "cardAging": "pirate", "calendarFeedEnabled": true, "background": "5abbe4b7ddc1b351ef961414", "backgroundImage": "<string>", "backgroundImageScaled": [ { "width": 100, "height": 64, "url": "https://trello-backgrounds.s3.amazonaws.com/SharedBackground/100x64/abc/photo-123.jpg" } ], "backgroundTile": true, "backgroundBrightness": "dark", "backgroundBottomColor": "#1e2e00", "backgroundTopColor": "#ffffff", "canBePublic": true, "canBeEnterprise": true, "canBeOrg": true, "canBePrivate": true, "canInvite": true }, "labelNames": { "green": "Addition", "yellow": "Update", "orange": "Deprecation", "red": "Deletion", "purple": "Power-Ups", "blue": "News", "sky": "Announcement", "lime": "Delight", "pink": "REST API", "black": "Capabilties" }, "limits": { "attachments": { "perBoard": { "status": "ok", "disableAt": 36000, "warnAt": 32400 } } }, "starred": true, "memberships": "<string>", "shortLink": "<string>", "subscribed": true, "powerUps": "<string>", "dateLastActivity": "<string>", "dateLastView": "<string>", "idTags": "<string>", "datePluginDisable": "<string>", "creationMethod": "<string>", "ixUpdate": 2154, "templateGallery": "<string>", "enterpriseOwned": true }
    GET

    Get the Card for an Action

    Get the card for an action

    Request

    Path parameters

    id

    TrelloID

    Required

    Query parameters

    fields

    CardFields

    Responses

    Success

    application/json

    Card
    GET/actions/{id}/card
    1 2 3 curl --request GET \ --url 'https://api.trello.com/1/actions/{id}/card?key=APIKey&token=APIToken' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 { "id": "5abbe4b7ddc1b351ef961414", "address": "<string>", "badges": { "attachmentsByType": { "trello": { "board": 2154, "card": 2154 } }, "location": true, "votes": 2154, "viewingMemberVoted": false, "subscribed": false, "fogbugz": "<string>", "checkItems": 0, "checkItemsChecked": 0, "comments": 0, "attachments": 0, "description": true, "due": "<string>", "start": "<string>", "dueComplete": true }, "checkItemStates": [ "<string>" ], "closed": true, "coordinates": "<string>", "creationMethod": "<string>", "dateLastActivity": "2019-09-16T16:19:17.156Z", "desc": "πŸ‘‹Hey there,\n\nTrello's Platform team uses this board to keep developers up-to-date.", "descData": { "emoji": {} }, "due": "<string>", "dueReminder": "<string>", "email": "bentleycook+2kea95u7kchsvqnxkwe+2q0byi6qv4pt9uc7q5m+25qyyohtzg@boards.trello.com", "idBoard": "5abbe4b7ddc1b351ef961414", "idChecklists": [ { "id": "5abbe4b7ddc1b351ef961414" } ], "idLabels": [ { "id": "5abbe4b7ddc1b351ef961414", "idBoard": "5abbe4b7ddc1b351ef961414", "name": "Overdue", "color": "yellow" } ], "idList": "5abbe4b7ddc1b351ef961414", "idMembers": [ "5abbe4b7ddc1b351ef961414" ], "idMembersVoted": [ "5abbe4b7ddc1b351ef961414" ], "idShort": 2154, "labels": [ "5abbe4b7ddc1b351ef961414" ], "limits": { "attachments": { "perBoard": { "status": "ok", "disableAt": 36000, "warnAt": 32400 } } }, "locationName": "<string>", "manualCoverAttachment": false, "name": "πŸ‘‹ What? Why? How?", "pos": 65535, "shortLink": "H0TZyzbK", "shortUrl": "https://trello.com/c/H0TZyzbK", "subscribed": false, "url": "https://trello.com/c/H0TZyzbK/4-%F0%9F%91%8B-what-why-how", "cover": { "color": "yellow", "idUploadedBackground": true, "size": "normal", "brightness": "light", "isTemplate": false } }
    GET

    Get the List for an Action

    Get the List for an Action

    Request

    Path parameters

    id

    TrelloID

    Required

    Query parameters

    fields

    ListFields

    Responses

    Success

    application/json

    TrelloList
    GET/actions/{id}/list
    1 2 3 curl --request GET \ --url 'https://api.trello.com/1/actions/{id}/list?key=APIKey&token=APIToken' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 { "id": "5abbe4b7ddc1b351ef961414", "name": "Things to buy today", "closed": true, "pos": 2154, "softLimit": "<string>", "idBoard": "<string>", "subscribed": true, "limits": { "attachments": { "perBoard": { "status": "ok", "disableAt": 36000, "warnAt": 32400 } } } }
    GET

    Get the Member of an Action

    Gets the member of an action (not the creator)

    Request

    Path parameters

    id

    TrelloID

    Required

    Query parameters

    fields

    MemberFields

    Responses

    Success

    application/json

    Member
    GET/actions/{id}/member
    1 2 3 curl --request GET \ --url 'https://api.trello.com/1/actions/{id}/member?key=APIKey&token=APIToken' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 { "id": "5abbe4b7ddc1b351ef961414", "activityBlocked": false, "avatarHash": "fc8faaaee46666a4eb8b626c08933e16", "avatarUrl": "https://trello-avatars.s3.amazonaws.com/fc8faaaee46666a4eb8b626c08933e16", "bio": "πŸ‘‹ I'm a developer advocate at Trello!", "bioData": { "emoji": {} }, "confirmed": true, "fullName": "Bentley Cook", "idEnterprise": "5abbe4b7ddc1b351ef961414", "idEnterprisesDeactivated": [ "<string>" ], "idMemberReferrer": "5abbe4b7ddc1b351ef961414", "idPremOrgsAdmin": [ "5abbe4b7ddc1b351ef961414" ], "initials": "BC", "memberType": "normal", "nonPublic": { "fullName": "Bentley Cook", "initials": "BC", "avatarUrl": "https://trello-members.s3.amazonaws.com/5b02e7f4e1facdc393169f9d/db2adf80c2e6c26b76e1f10400eb4c45", "avatarHash": "db2adf80c2e6c26b76e1f10400eb4c45" }, "nonPublicAvailable": false, "products": [ 2154 ], "url": "https://trello.com/bentleycook", "username": "bentleycook", "status": "disconnected", "aaEmail": "<string>", "aaEnrolledDate": "<string>", "aaId": "<string>", "avatarSource": "gravatar", "email": "bcook@atlassian.com", "gravatarHash": "0a1e804f6e35a65ae5e1f7ef4c92471c", "idBoards": [ "5abbe4b7ddc1b351ef961414" ], "idOrganizations": [ "5abbe4b7ddc1b351ef961414" ], "idEnterprisesAdmin": [ "5abbe4b7ddc1b351ef961414" ], "limits": { "status": "ok", "disableAt": 36000, "warnAt": 32400 }, "loginTypes": [ "password" ], "marketingOptIn": { "optedIn": false, "date": "2018-04-26T17:03:25.155Z" }, "messagesDismissed": { "name": "ad-security-features", "count": "<string>", "lastDismissed": "2019-03-11T20:19:46.809Z", "_id": "5abbe4b7ddc1b351ef961414" }, "oneTimeMessagesDismissed": [ "<string>" ], "prefs": { "timezoneInfo": { "offsetCurrent": 360, "timezoneCurrent": "CST", "offsetNext": 300, "dateNext": "2020-03-08T08:00:00.000Z", "timezoneNext": "CDT" }, "privacy": { "fullName": "public", "avatar": "public" }, "sendSummaries": true, "minutesBetweenSummaries": 60, "minutesBeforeDeadlineToNotify": 1440, "colorBlind": true, "locale": "en-AU", "timezone": "America/Chicago", "twoFactor": { "enabled": true, "needsNewBackups": false } }, "trophies": [ "<string>" ], "uploadedAvatarHash": "dac3ad49ff117829dd63a79bb2ea3426", "uploadedAvatarUrl": "https://trello-avatars.s3.amazonaws.com/dac3ad49ff117829dd63a79bb2ea3426", "premiumFeatures": [ "<string>" ], "isAaMastered": false, "ixUpdate": 2154, "idBoardsPinned": [ "5abbe4b7ddc1b351ef961414" ] }
    GET

    Get the Member Creator of an Action

    Get the Member who created the Action

    Request

    Path parameters

    id

    TrelloID

    Required

    Query parameters

    fields

    MemberFields

    Responses

    Success

    application/json

    Member
    GET/actions/{id}/memberCreator
    1 2 3 curl --request GET \ --url 'https://api.trello.com/1/actions/{id}/memberCreator?key=APIKey&token=APIToken' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 { "id": "5abbe4b7ddc1b351ef961414", "activityBlocked": false, "avatarHash": "fc8faaaee46666a4eb8b626c08933e16", "avatarUrl": "https://trello-avatars.s3.amazonaws.com/fc8faaaee46666a4eb8b626c08933e16", "bio": "πŸ‘‹ I'm a developer advocate at Trello!", "bioData": { "emoji": {} }, "confirmed": true, "fullName": "Bentley Cook", "idEnterprise": "5abbe4b7ddc1b351ef961414", "idEnterprisesDeactivated": [ "<string>" ], "idMemberReferrer": "5abbe4b7ddc1b351ef961414", "idPremOrgsAdmin": [ "5abbe4b7ddc1b351ef961414" ], "initials": "BC", "memberType": "normal", "nonPublic": { "fullName": "Bentley Cook", "initials": "BC", "avatarUrl": "https://trello-members.s3.amazonaws.com/5b02e7f4e1facdc393169f9d/db2adf80c2e6c26b76e1f10400eb4c45", "avatarHash": "db2adf80c2e6c26b76e1f10400eb4c45" }, "nonPublicAvailable": false, "products": [ 2154 ], "url": "https://trello.com/bentleycook", "username": "bentleycook", "status": "disconnected", "aaEmail": "<string>", "aaEnrolledDate": "<string>", "aaId": "<string>", "avatarSource": "gravatar", "email": "bcook@atlassian.com", "gravatarHash": "0a1e804f6e35a65ae5e1f7ef4c92471c", "idBoards": [ "5abbe4b7ddc1b351ef961414" ], "idOrganizations": [ "5abbe4b7ddc1b351ef961414" ], "idEnterprisesAdmin": [ "5abbe4b7ddc1b351ef961414" ], "limits": { "status": "ok", "disableAt": 36000, "warnAt": 32400 }, "loginTypes": [ "password" ], "marketingOptIn": { "optedIn": false, "date": "2018-04-26T17:03:25.155Z" }, "messagesDismissed": { "name": "ad-security-features", "count": "<string>", "lastDismissed": "2019-03-11T20:19:46.809Z", "_id": "5abbe4b7ddc1b351ef961414" }, "oneTimeMessagesDismissed": [ "<string>" ], "prefs": { "timezoneInfo": { "offsetCurrent": 360, "timezoneCurrent": "CST", "offsetNext": 300, "dateNext": "2020-03-08T08:00:00.000Z", "timezoneNext": "CDT" }, "privacy": { "fullName": "public", "avatar": "public" }, "sendSummaries": true, "minutesBetweenSummaries": 60, "minutesBeforeDeadlineToNotify": 1440, "colorBlind": true, "locale": "en-AU", "timezone": "America/Chicago", "twoFactor": { "enabled": true, "needsNewBackups": false } }, "trophies": [ "<string>" ], "uploadedAvatarHash": "dac3ad49ff117829dd63a79bb2ea3426", "uploadedAvatarUrl": "https://trello-avatars.s3.amazonaws.com/dac3ad49ff117829dd63a79bb2ea3426", "premiumFeatures": [ "<string>" ], "isAaMastered": false, "ixUpdate": 2154, "idBoardsPinned": [ "5abbe4b7ddc1b351ef961414" ] }
    GET

    Get the Organization of an Action

    Get the Organization of an Action

    Request

    Path parameters

    id

    TrelloID

    Required

    Query parameters

    fields

    OrganizationFields

    Responses

    Success

    application/json

    Organization
    GET/actions/{id}/organization
    1 2 3 curl --request GET \ --url 'https://api.trello.com/1/actions/{id}/organization?key=APIKey&token=APIToken' \ --header 'Accept: application/json'
    200Response
    1 2 3 { "id": "5abbe4b7ddc1b351ef961414" }
    PUT

    Update a Comment Action

    Update a comment action

    Request

    Path parameters

    id

    TrelloID

    Required

    Query parameters

    value

    string

    Required

    Responses

    Success

    PUT/actions/{id}/text
    1 2 curl --request PUT \ --url 'https://api.trello.com/1/actions/{id}/text?value={value}&key=APIKey&token=APIToken'
    GET

    Get Action's Reactions

    List reactions for an action

    Request

    Path parameters

    idAction

    TrelloID

    Required

    Query parameters

    member

    boolean

    emoji

    boolean

    Responses

    Success

    GET/actions/{idAction}/reactions
    1 2 curl --request GET \ --url 'https://api.trello.com/1/actions/{idAction}/reactions?key=APIKey&token=APIToken'
    POST

    Create Reaction for Action

    Adds a new reaction to an action

    Request

    Path parameters

    idAction

    TrelloID

    Required

    Request bodyapplication/json

    shortName

    string

    skinVariation

    string

    native

    string

    unified

    string

    Responses

    Success

    POST/actions/{idAction}/reactions
    1 2 3 4 5 6 7 8 9 curl --request POST \ --url 'https://api.trello.com/1/actions/{idAction}/reactions?key=APIKey&token=APIToken' \ --header 'Content-Type: application/json' \ --data '{ "shortName": "<string>", "skinVariation": "<string>", "native": "<string>", "unified": "<string>" }'
    GET

    Get Action's Reaction

    Get information for a reaction

    Request

    Path parameters

    idAction

    TrelloID

    Required
    id

    TrelloID

    Required

    Query parameters

    member

    boolean

    emoji

    boolean

    Responses

    Success

    GET/actions/{idAction}/reactions/{id}
    1 2 curl --request GET \ --url 'https://api.trello.com/1/actions/{idAction}/reactions/{id}?key=APIKey&token=APIToken'
    DEL

    Delete Action's Reaction

    Deletes a reaction

    Request

    Path parameters

    idAction

    TrelloID

    Required
    id

    TrelloID

    Required

    Responses

    Success

    DEL/actions/{idAction}/reactions/{id}
    1 2 curl --request DELETE \ --url 'https://api.trello.com/1/actions/{idAction}/reactions/{id}?key=APIKey&token=APIToken'
    GET

    List Action's summary of Reactions

    List a summary of all reactions for an action

    Request

    Path parameters

    idAction

    TrelloID

    Required

    Responses

    Success

    GET/actions/{idAction}/reactionsSummary
    1 2 curl --request GET \ --url 'https://api.trello.com/1/actions/{idAction}/reactionsSummary?key=APIKey&token=APIToken'