Create a new card. Query parameters may also be replaced with a JSON request body instead.
string
string
oneOf [string, number]
string
string
boolean
TrelloID
Requiredarray<TrelloID>
array<TrelloID>
string
Success
1
2
3
curl --request POST \
--url 'https://api.trello.com/1/cards?idList=5abbe4b7ddc1b351ef961414&key=APIKey&token=APIToken' \
--header 'Accept: application/json'
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 a card by its ID
TrelloID
Requiredstring
string
oneOf [string, boolean]
string
boolean
string
boolean
string
boolean
string
Success
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/cards/{id}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
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
}
}
Update a card. Query parameters may also be replaced with a JSON request body instead.
TrelloID
Requiredstring
string
boolean
TrelloID
TrelloID
TrelloID
TrelloID
TrelloID
oneOf [string, number]
string
Success
1
2
3
curl --request PUT \
--url 'https://api.trello.com/1/cards/{id}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
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
}
}
Delete a Card
TrelloID
RequiredSuccess
1
2
curl --request DELETE \
--url 'https://api.trello.com/1/cards/{id}?key=APIKey&token=APIToken'
Get a specific property of a card
TrelloID
RequiredCardFields
RequiredSuccess
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/cards/{id}/{field}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
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
}
}
List the Actions on a Card. See Nested Resources for more information.
TrelloID
Requiredstring
number
Success
array<Action>
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/cards/{id}/actions?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
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
[
{
"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"
}
}
]
List the attachments on a card
TrelloID
Requiredstring
string
Success
array<Attachment>
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/cards/{id}/attachments?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
[
{
"id": "5abbe4b7ddc1b351ef961414",
"bytes": "<string>",
"date": "2018-10-17T19:10:14.808Z",
"edgeColor": "yellow",
"idMember": "5abbe4b7ddc1b351ef961414",
"isUpload": false,
"mimeType": "",
"name": "Deprecation Extension Notice",
"previews": [],
"url": "https://admin.typeform.com/form/RzExEM/share#/link",
"pos": 1638
}
]
Create an Attachment to a Card. See https://glitch.com/~trello-attachments-api for code examples. You may need to remix the project in order to view it.
TrelloID
Requiredstring
string
string
string
boolean
Success
array<Attachment>
1
2
3
curl --request POST \
--url 'https://api.trello.com/1/cards/{id}/attachments?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
[
{
"id": "5abbe4b7ddc1b351ef961414",
"bytes": "<string>",
"date": "2018-10-17T19:10:14.808Z",
"edgeColor": "yellow",
"idMember": "5abbe4b7ddc1b351ef961414",
"isUpload": false,
"mimeType": "",
"name": "Deprecation Extension Notice",
"previews": [],
"url": "https://admin.typeform.com/form/RzExEM/share#/link",
"pos": 1638
}
]
Get a specific Attachment on a Card.
TrelloID
RequiredTrelloID
Requiredarray<AttachmentFields>
Success
array<Attachment>
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/cards/{id}/attachments/{idAttachment}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
[
{
"id": "5abbe4b7ddc1b351ef961414",
"bytes": "<string>",
"date": "2018-10-17T19:10:14.808Z",
"edgeColor": "yellow",
"idMember": "5abbe4b7ddc1b351ef961414",
"isUpload": false,
"mimeType": "",
"name": "Deprecation Extension Notice",
"previews": [],
"url": "https://admin.typeform.com/form/RzExEM/share#/link",
"pos": 1638
}
]
Delete an Attachment
TrelloID
RequiredTrelloID
RequiredSuccess
1
2
curl --request DELETE \
--url 'https://api.trello.com/1/cards/{id}/attachments/{idAttachment}?key=APIKey&token=APIToken'
Get the board a card is on
TrelloID
Requiredstring
Success
1
2
curl --request GET \
--url 'https://api.trello.com/1/cards/{id}/board?key=APIKey&token=APIToken'
Get the completed checklist items on a card
TrelloID
Requiredstring
Success
1
2
curl --request GET \
--url 'https://api.trello.com/1/cards/{id}/checkItemStates?key=APIKey&token=APIToken'
Get the checklists on a card
TrelloID
Requiredstring
string
string
string
Success
1
2
curl --request GET \
--url 'https://api.trello.com/1/cards/{id}/checklists?key=APIKey&token=APIToken'
Create a new checklist on a card
TrelloID
Requiredstring
TrelloID
string
Success
1
2
curl --request POST \
--url 'https://api.trello.com/1/cards/{id}/checklists?key=APIKey&token=APIToken'
Get a specific checkItem on a card
TrelloID
RequiredTrelloID
Requiredstring
Success
1
2
curl --request GET \
--url 'https://api.trello.com/1/cards/{id}/checkItem/{idCheckItem}?key=APIKey&token=APIToken'
Update an item in a checklist on a card.
TrelloID
RequiredTrelloID
Requiredstring
string
TrelloID
oneOf [string, number]
string
number
TrelloID
Success
1
2
curl --request PUT \
--url 'https://api.trello.com/1/cards/{id}/checkItem/{idCheckItem}?key=APIKey&token=APIToken'
Delete a checklist item
TrelloID
RequiredTrelloID
RequiredSuccess
1
2
curl --request DELETE \
--url 'https://api.trello.com/1/cards/{id}/checkItem/{idCheckItem}?key=APIKey&token=APIToken'
Get the list a card is in
TrelloID
Requiredstring
Success
1
2
curl --request GET \
--url 'https://api.trello.com/1/cards/{id}/list?key=APIKey&token=APIToken'
Get the members on a card
TrelloID
Requiredstring
Success
1
2
curl --request GET \
--url 'https://api.trello.com/1/cards/{id}/members?key=APIKey&token=APIToken'
Get the members who have voted on a card
TrelloID
Requiredstring
Success
1
2
curl --request GET \
--url 'https://api.trello.com/1/cards/{id}/membersVoted?key=APIKey&token=APIToken'
Vote on the card for a given member.
TrelloID
RequiredTrelloID
RequiredSuccess
1
2
curl --request POST \
--url 'https://api.trello.com/1/cards/{id}/membersVoted?value=5abbe4b7ddc1b351ef961414&key=APIKey&token=APIToken'
Get any shared pluginData on a card.
TrelloID
RequiredSuccess
1
2
curl --request GET \
--url 'https://api.trello.com/1/cards/{id}/pluginData?key=APIKey&token=APIToken'
Get the stickers on a card
TrelloID