Get an enterprise by its ID.
TrelloID
Requiredstring
string
string
string
string
string
string
integer
integer
string
Success
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/enterprises/{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
{
"id": "5abbe4b7ddc1b351ef961414",
"name": "bentley_test",
"displayName": "Bentley's Test Enterprise!",
"logoHash": "<string>",
"logoUrl": "<string>",
"prefs": {
"ssoOnly": false,
"signup": {
"banner": "<string>",
"bannerHtml": "<p>Hello</p>\n"
},
"mandatoryTransferDate": "<string>",
"brandingColor": "<string>",
"autoJoinOrganizations": false,
"notifications": {},
"maxMembers": 2154
},
"organizationPrefs": {
"boardVisibilityRestrict": {},
"boardDeleteRestrict": {},
"attachmentRestrictions": [
"computer"
]
},
"ssoActivationFailed": true,
"idAdmins": [
"5abbe4b7ddc1b351ef961414"
],
"enterpriseDomains": [
"<string>"
],
"isRealEnterprise": true,
"pluginWhitelistingEnabled": [
"5abbe4b7ddc1b351ef961414"
],
"idOrganizations": [
"5abbe4b7ddc1b351ef961414"
],
"products": [
2154
],
"licenses": {
"maxMembers": 2154,
"totalMembers": 5,
"relatedEnterprises": [
{
"name": "enterprise_name",
"displayName": "My Test Enterprise!",
"count": 5
}
]
},
"domains": [
"<string>"
],
"dateOrganizationPrefsLastUpdated": "2019-08-22T18:15:53.546Z",
"idp": {
"requestSigned": false,
"certificate": "<string>",
"loginUrl": "<string>"
}
}
Returns an array of Actions related to the Enterprise object. Used for populating data sent to Google Sheets from an Enterprise's audit log page: https://trello.com/e/{enterprise_name}/admin/auditlog. An Enterprise admin token is required for this route.
NOTE: For enterprises that have opted in to user management via AdminHub, the auditlog will will contain actions taken in AdminHub, but may not contain the source for those actions.
TrelloID
RequiredSuccess
array<EnterpriseAuditLog>
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/enterprises/{id}/auditlog?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
[
{
"idAction": "5abbe4b7ddc1b351ef961414",
"type": "addOrganizationToEnterprise",
"date": "2018-04-26T17:03:25.155Z",
"memberCreator": {
"id": "5abbe4b7ddc1b351ef961414",
"username": "bobloblaw",
"fullName": "Bob Loblaw (Trello)"
},
"organization": {
"enterpriseJoinRequest": {
"idEnterprise": "5abbe4b7ddc1b351ef961414",
"idMember": "5abbe4b7ddc1b351ef961414",
"date": "2018-04-26T17:03:25.155Z"
},
"id": "5abbe4b7ddc1b351ef961414",
"name": "organization name"
},
"member": {
"id": "5abbe4b7ddc1b351ef961414",
"username": "bentleycook",
"fullName": "Bentley Cook"
}
}
]
Get an enterprise's admin members.
TrelloID
Requiredstring
Success
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/enterprises/{id}/admins?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
1
2
3
4
5
{
"id": "5abbe4b7ddc1b351ef961414",
"fullName": "Bob Loblaw",
"username": "bobloblaw"
}
Get the signup URL for an enterprise.
TrelloID
Requiredboolean
boolean
string
boolean
Success
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/enterprises/{id}/signupUrl?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
1
2
3
{
"signupUrl": "<string>"
}
Get an enterprise's users. You can choose to retrieve licensed members, board guests, etc.
TrelloID
Requiredboolean
boolean
boolean
boolean
boolean
string
string
string
string
Success
array<Membership>
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/enterprises/{id}/members/query?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
[
{
"managed": true,
"licensed": true,
"admin": true,
"deactivated": true,
"collaborator": true,
"member": {
"id": "646e92a0a016198d3cf81e8a",
"fullname": "Lex Math",
"username": "amath",
"dateLastImpression": "2023-05-24T22:41:36.406Z",
"email": "amath@trello.com",
"initials": "AM",
"avatarURL": "trello.com/avatarURL",
"memberType": "Admin",
"confirmed": true
}
}
]
Get the members of an enterprise.
TrelloID
Requiredstring
string
string
string
string
integer
string
string
string
Success
array<Member>
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/enterprises/{id}/members?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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
[
{
"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 a specific member of an enterprise by ID.
TrelloID
RequiredTrelloID
Requiredstring
string
string
Success
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/enterprises/{id}/members/{idMember}?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
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 whether an organization can be transferred to an enterprise.
TrelloID
RequiredTrelloID
RequiredSuccess
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/enterprises/{id}/transferrable/organization/{idOrganization}?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
{
"transferrable": true,
"newBillableMembers": [
{
"id": "5abbe4b7ddc1b351ef961414",
"fullName": "Bob Loblaw",
"username": "bobloblaw",
"initials": "BL",
"avatarHash": "fc8faaaee46666a4eb8b626c08933e16"
}
],
"restrictedMembers": [
{
"id": "5abbe4b7ddc1b351ef961414",
"fullName": "Bob Loblaw",
"username": "bobloblaw",
"initials": "BL",
"avatarHash": "fc8faaaee46666a4eb8b626c08933e16"
}
]
}
Get a list of organizations that can be transferred to an enterprise when given a bulk list of organizations.
TrelloID
Requiredarray<Organization>
RequiredSuccess
array<TransferrableOrganization>
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/enterprises/{id}/transferrable/bulk/{idOrganizations}?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
[
{
"transferrable": true,
"newBillableMembers": [
{
"id": "5abbe4b7ddc1b351ef961414",
"fullName": "Bob Loblaw",
"username": "bobloblaw",
"initials": "BL",
"avatarHash": "fc8faaaee46666a4eb8b626c08933e16"
}
],
"restrictedMembers": [
{
"id": "5abbe4b7ddc1b351ef961414",
"fullName": "Bob Loblaw",
"username": "bobloblaw",
"initials": "BL",
"avatarHash": "fc8faaaee46666a4eb8b626c08933e16"
}
]
}
]
Decline enterpriseJoinRequests from one organization or bulk amount of organizations
TrelloID
Requiredarray<Organization>
RequiredSuccess
1
2
curl --request PUT \
--url 'https://api.trello.com/1/enterprises/${id}/enterpriseJoinRequest/bulk?idOrganizations={idOrganizations}&key=APIKey&token=APIToken'
Get the Workspaces that are claimable by the enterprise by ID. Can optionally query for workspaces based on activeness/ inactiveness.
TrelloID
Requiredinteger
string
string
string
string
Success
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/enterprises/{id}/claimableOrganizations?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
{
"organizations": [
{
"name": "organization_name",
"displayName": "Organization Name",
"activeMembershipCount": 5,
"idActiveAdmins": [
"5abbe4b7ddc1b351ef961414"
],
"products": [
2154
],
"id": "5abbe4b7ddc1b351ef961414",
"logoUrl": "<string>",
"dateLastActive": "2019-08-22T18:15:53.546Z"
}
],
"claimableCount": 2
}
Get the Workspaces that are pending for the enterprise by ID.
TrelloID
Requiredstring
string
Success
array<PendingOrganizations>
1
2
3
curl --request GET \
--url 'https://api.trello.com/1/enterprises/{id}/pendingOrganizations?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
[
{
"id": "5abbe4b7ddc1b351ef961414",
"idMember": "5abbe4b7ddc1b351ef961414",
"memberRequestor": {
"id": "5abbe4b7ddc1b351ef961414",
"fullName": "Bob Loblaw (Trello)"
},
"date": "2018-10-17T19:10:14.808Z",
"displayName": "Organization Name",
"membershipCount": 2,
"logoUrl": "<string>",
"transferability": {
"transferrable": true,
"newBillableMembers": [
{
"id": "5abbe4b7ddc1b351ef961414",
"fullName": "Bob Loblaw",
"username": "bobloblaw",
"initials": "BL",
"avatarHash": "fc8faaaee46666a4eb8b626c08933e16"
}
],
"restrictedMembers": [
{
"id": "5abbe4b7ddc1b351ef961414",
"fullName": "Bob Loblaw",
"username": "bobloblaw",
"initials": "BL",
"avatarHash": "fc8faaaee46666a4eb8b626c08933e16"
}
]
}
}
]
Create an auth Token for an Enterprise.
string
Requiredstring
Success
1
2
curl --request POST \
--url 'https://api.trello.com/1/enterprises/{id}/tokens?key=APIKey&token=APIToken'
Transfer an organization to an enterprise.
NOTE: For enterprises that have opted in to user management via AdminHub, this endpoint will result in the organization being added to the enterprise asynchronously. A 200 response only indicates receipt of the request, it does not indicate successful addition to the enterprise.
TrelloID
Requiredstring
RequiredSuccess
array<Organization>
1
2
3
curl --request PUT \
--url 'https://api.trello.com/1/enterprises/{id}/organizations?idOrganization={idOrganization}&key=APIKey&token=APIToken' \
--header 'Accept: application/json'
1
2
3
4
5
[
{
"id": "5abbe4b7ddc1b351ef961414"
}
]
This endpoint is used to update whether the provided Member should use one of the Enterprise's available licenses or not. Revoking a license will deactivate a Member of an Enterprise.
NOTE: Revoking of licenses is not possible for enterprises that have opted in to user management via AdminHub.
TrelloID
RequiredTrelloID
Requiredboolean
RequiredSuccess
1
2
3
curl --request PUT \
--url 'https://api.trello.com/1/enterprises/{id}/members/{idMember}/licensed?value={value}&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
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"
]
}
Deactivate a Member of an Enterprise.
NOTE: Deactivation is not possible for enterprises that have opted in to user management via AdminHub.
TrelloID
RequiredTrelloID
Requiredboolean
RequiredMemberFields
OrganizationFields
BoardFields
Success
1
2
curl --request PUT \
--url 'https://api.trello.com/1/enterprises/{id}/members/{idMember}/deactivated?value={value}&key=APIKey&token=APIToken'
Make Member an admin of Enterprise.
NOTE: This endpoint is not available to enterprises that have opted in to user management via AdminHub.