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

    Actions

    Postman Collection
    OpenAPI
    GET

    Get an Action

    Get an Action

    Forge and OAuth2 apps cannot access this REST resource.

    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.

    Forge and OAuth2 apps cannot access this REST resource.

    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.

    Forge and OAuth2 apps cannot access this REST resource.

    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

    Forge and OAuth2 apps cannot access this REST resource.

    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

    Forge and OAuth2 apps cannot access this REST resource.

    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

    Forge and OAuth2 apps cannot access this REST resource.

    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 { "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>", "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

    Forge and OAuth2 apps cannot access this REST resource.

    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)

    Forge and OAuth2 apps cannot access this REST resource.

    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

    Forge and OAuth2 apps cannot access this REST resource.

    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

    Forge and OAuth2 apps cannot access this REST resource.

    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

    Forge and OAuth2 apps cannot access this REST resource.

    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

    Forge and OAuth2 apps cannot access this REST resource.

    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

    Forge and OAuth2 apps cannot access this REST resource.

    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

    Forge and OAuth2 apps cannot access this REST resource.

    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

    Forge and OAuth2 apps cannot access this REST resource.

    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

    Forge and OAuth2 apps cannot access this REST resource.

    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'

    Rate this page: