Rate this page:
GET /1/members/{id}
Get a member
oneOf [string, string]
The ID or username of the member
string
See the Actions Nested Resource
string
See the Boards Nested Resource
string
One of: all
, custom
, default
, none
, premium
none
Valid values: all
, custom
, default
, none
, premium
string
all
or a comma-separated list of: closed, members, open, organization, pinned, public, starred, unpinned
Valid values: closed
, members
, open
, organization
, pinned
, public
, starred
, unpinned
string
all
or a comma-separated list of board fields
form
Valid values: id
, name
, desc
, descData
, closed
, idMemberCreator
, idOrganization
, pinned
, url
, shortUrl
...(Show more)
boolean
Whether to return the boardStars or not
false
string
See the Cards Nested Resource for additional options
none
string
all
or none
none
Valid values: all
, none
string
all
or none
none
Valid values: all
, none
string
all
or none
none
Valid values: all
, none
string
all
or a comma-separated list of member fields
Valid values: id
string
See the Notifications Nested Resource
string
One of: all
, members
, none
, public
none
Valid values: all
, members
, none
, public
string
all
or a comma-separated list of organization fields
Valid values: id
, name
boolean
Whether or not to include paid account information in the returned workspace object
false
string
One of: all
, members
, none
, public
none
Valid values: all
, members
, none
, public
string
all
or a comma-separated list of organization fields
Valid values: id
, name
boolean
Whether or not to include paid account information in the returned member object
false
boolean
false
string
all
or none
none
Valid values: all
, none
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
PUT /1/members/{id}
Update a Member
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
New name for the member. Cannot begin or end with a space.
string
New initials for the member. 1-4 characters long.
1
, Max length: 4
string
New username for the member. At least 3 characters long, only lowercase letters, underscores, and numbers. Must be unique.
string
string
One of: gravatar
, none
, upload
Valid values: gravatar
, none
, upload
boolean
string
integer
-1
for disabled, 1
, or 60
int32
1 2 3
curl --request PUT \
--url 'https://api.trello.com/1/members/{id}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
GET /1/members/{id}/{field}
Get a particular property of a member
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
One of the member fields
Valid values: id
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/{field}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
GET /1/members/{id}/actions
List the actions for a member
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
A comma-separated list of action types.
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/actions?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json | Array<Member> |
GET /1/members/{id}/boardBackgrounds
Get a member's custom board backgrounds
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
One of: all
, custom
, default
, none
, premium
all
Valid values: all
, custom
, default
, none
, premium
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/boardBackgrounds?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json | Array<BoardBackground> |
POST /1/members/{id}/boardBackgrounds
Upload a new boardBackground
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
binary
1 2 3
curl --request POST \
--url 'https://api.trello.com/1/members/{id}/boardBackgrounds?file={file}&key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json | Array<BoardBackground> |
GET /1/members/{id}/boardBackgrounds/{idBackground}
Get a member's board background
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
The ID of the board background
^[0-9a-fA-F]{24}$
string
all
or a comma-separated list of: brightness
, fullSizeUrl
, scaled
, tile
all
Valid values: all
, brightness
, fullSizeUrl
, scaled
, tile
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/boardBackgrounds/{idBackground}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
PUT /1/members/{id}/boardBackgrounds/{idBackground}
Update a board background
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
The ID of the board background
^[0-9a-fA-F]{24}$
string
One of: dark
, light
, unknown
Valid values: dark
, light
, unknown
boolean
Whether the background should be tiled
1 2 3
curl --request PUT \
--url 'https://api.trello.com/1/members/{id}/boardBackgrounds/{idBackground}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
DELETE /1/members/{id}/boardBackgrounds/{idBackground}
Delete a board background
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
The ID of the board background
^[0-9a-fA-F]{24}$
1 2
curl --request DELETE \
--url 'https://api.trello.com/1/members/{id}/boardBackgrounds/{idBackground}?key=APIKey&token=APIToken'
Success
A schema has not been defined for this response code.
GET /1/members/{id}/boardStars
List a member's board stars
string
The ID or username of the member
^[0-9a-fA-F]{24}$
1 2
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/boardStars?key=APIKey&token=APIToken'
Success
A schema has not been defined for this response code.
POST /1/members/{id}/boardStars
Star a new board on behalf of a Member
oneOf [string, string]
The ID or username of the member
string
The ID of the board to star
^[0-9a-fA-F]{24}$
oneOf [string, number]
The position of the newly starred board. top
, bottom
, or a positive float.
1 2 3
curl --request POST \
--url 'https://api.trello.com/1/members/{id}/boardStars?idBoard=5abbe4b7ddc1b351ef961414&pos={pos}&key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json | Array<BoardStars> |
GET /1/members/{id}/boardStars/{idStar}
Get a specific boardStar
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
The ID of the board star
^[0-9a-fA-F]{24}$
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/boardStars/{idStar}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
PUT /1/members/{id}/boardStars/{idStar}
Update the position of a starred board
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
The ID of the board star
^[0-9a-fA-F]{24}$
oneOf [string, number]
New position for the starred board. top
, bottom
, or a positive float.
1 2
curl --request PUT \
--url 'https://api.trello.com/1/members/{id}/boardStars/{idStar}?key=APIKey&token=APIToken'
Success
A schema has not been defined for this response code.
DELETE /1/members/{id}/boardStars/{idStar}
Unstar a board
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
The ID of the board star
^[0-9a-fA-F]{24}$
1 2
curl --request DELETE \
--url 'https://api.trello.com/1/members/{id}/boardStars/{idStar}?key=APIKey&token=APIToken'
Success
A schema has not been defined for this response code.
GET /1/members/{id}/boards
Lists the boards that the user is a member of.
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
all
or a comma-separated list of: closed
, members
, open
, organization
, public
, starred
all
Valid values: all
, closed
, members
, open
, organization
, public
, starred
string
all
or a comma-separated list of board fields
Valid values: id
, name
, desc
, descData
, closed
, idMemberCreator
, idOrganization
, pinned
, url
, shortUrl
...(Show more)
string
Which lists to include with the boards. One of: all
, closed
, none
, open
none
Valid values: all
, closed
, none
, open
boolean
Whether to include the Organization object with the Boards
false
string
all
or a comma-separated list of organization fields
form
Valid values: id
, name
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/boards?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json | Array<Board> |
GET /1/members/{id}/boardsInvited
Get the boards the member has been invited to
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
all
or a comma-separated list of board fields
Valid values: id
, name
, desc
, descData
, closed
, idMemberCreator
, idOrganization
, pinned
, url
, shortUrl
...(Show more)
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/boardsInvited?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json | Array<Board> |
GET /1/members/{id}/cards
Gets the cards a member is on
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
One of: all
, closed
, none
, open
, visible
visible
Valid values: all
, closed
, none
, open
, visible
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/cards?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json | Array<Card> |
GET /1/members/{id}/customBoardBackgrounds
Get a member's custom board backgrounds
string
The ID or username of the member
^[0-9a-fA-F]{24}$
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/customBoardBackgrounds?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json | Array<BoardBackground> |
POST /1/members/{id}/customBoardBackgrounds
Upload a new custom board background
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
binary
1 2 3
curl --request POST \
--url 'https://api.trello.com/1/members/{id}/customBoardBackgrounds?file={file}&key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
GET /1/members/{id}/customBoardBackgrounds/{idBackground}
Get a specific custom board background
oneOf [string, string]
The ID or username of the member
string
The ID of the custom background
^[0-9a-fA-F]{24}$
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/customBoardBackgrounds/{idBackground}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
PUT /1/members/{id}/customBoardBackgrounds/{idBackground}
Update a specific custom board background
oneOf [string, string]
The ID or username of the member
string
The ID of the custom background
^[0-9a-fA-F]{24}$
string
One of: dark
, light
, unknown
Valid values: dark
, light
, unknown
boolean
Whether to tile the background
1 2 3
curl --request PUT \
--url 'https://api.trello.com/1/members/{id}/customBoardBackgrounds/{idBackground}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
DELETE /1/members/{id}/customBoardBackgrounds/{idBackground}
Delete a specific custom board background
oneOf [string, string]
The ID or username of the member
string
The ID of the custom background
^[0-9a-fA-F]{24}$
1 2
curl --request DELETE \
--url 'https://api.trello.com/1/members/{id}/customBoardBackgrounds/{idBackground}?key=APIKey&token=APIToken'
Success
A schema has not been defined for this response code.
GET /1/members/{id}/customEmoji
Get a Member's uploaded custom Emojis
string
The ID or username of the member
^[0-9a-fA-F]{24}$
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/customEmoji?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json | Array<CustomEmoji> |
POST /1/members/{id}/customEmoji
Create a new custom Emoji
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
binary
string
Name for the emoji. 2 - 64 characters
2
, Max length: 64
1 2 3
curl --request POST \
--url 'https://api.trello.com/1/members/{id}/customEmoji?file={file}&name={name}&key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
GET /1/members/{id}/customEmoji/{idEmoji}
Get a Member's custom Emoji
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
The ID of the custom emoji
^[0-9a-fA-F]{24}$
string
all
or a comma-separated list of name
, url
form
, Default: all
Valid values: name
, url
, all
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/customEmoji/{idEmoji}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
GET /1/members/{id}/customStickers
Get a Member's uploaded stickers
string
The ID or username of the member
^[0-9a-fA-F]{24}$
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/customStickers?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json | Array<CustomSticker> |
POST /1/members/{id}/customStickers
Upload a new custom sticker
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
binary
1 2 3
curl --request POST \
--url 'https://api.trello.com/1/members/{id}/customStickers?file={file}&key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
GET /1/members/{id}/customStickers/{idSticker}
Get a Member's custom Sticker
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
The ID of the uploaded sticker
^[0-9a-fA-F]{24}$
string
all
or a comma-separated list of scaled
, url
form
, Default: all
Valid values: scaled
, url
, all
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/customStickers/{idSticker}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
DELETE /1/members/{id}/customStickers/{idSticker}
Delete a Member's custom Sticker
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
The ID of the uploaded sticker
^[0-9a-fA-F]{24}$
1 2
curl --request DELETE \
--url 'https://api.trello.com/1/members/{id}/customStickers/{idSticker}?key=APIKey&token=APIToken'
Success
A schema has not been defined for this response code.
GET /1/members/{id}/notifications
Get a member's notifications
string
The ID or username of the member
^[0-9a-fA-F]{24}$
boolean
false
boolean
false
string
all
string
One of: all
, read
, unread
all
string
all
or a comma-separated list of notification fields
all
integer
Max 1000
50
, Format: int32
integer
Max 100
0
, Format: int32
string
A notification ID
string
A notification ID
boolean
true
string
all
or a comma-separated list of member fields
avatarHash,fullName,initials,username
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/notifications?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json | Array<Notification> |
GET /1/members/{id}/organizations
Get a member's Workspaces
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
One of: all
, members
, none
, public
(Note: members
filters to only private Workspaces)
all
Valid values: all
, members
, none
, public
string
all
or a comma-separated list of organization fields
form
Valid values: id
, name
boolean
Whether or not to include paid account information in the returned workspace object
false
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/organizations?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json | Array<Organization> |
GET /1/members/{id}/organizationsInvited
Get a member's Workspaces they have been invited to
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
all
or a comma-separated list of organization fields
Valid values: id
, name
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/organizationsInvited?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json | Array<Organization> |
GET /1/members/{id}/savedSearches
List the saved searches of a Member
string
The ID or username of the member
^[0-9a-fA-F]{24}$
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/savedSearches?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json | Array<SavedSearch> |
POST /1/members/{id}/savedSearches
Create a saved search
string
The ID or username of the member
^[0-9a-fA-F]{24}$
string
The name for the saved search
string
The search query
oneOf [string, number]
The position of the saved search. top
, bottom
, or a positive float.
1 2 3
curl --request POST \
--url 'https://api.trello.com/1/members/{id}/savedSearches?name={name}&query={query}&pos={pos}&key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
GET /1/members/{id}/savedSearches/{idSearch}
Get a saved search
string
The ID or username of the member
string
The ID of the saved search to delete
1 2 3
curl --request GET \
--url 'https://api.trello.com/1/members/{id}/savedSearches/{idSearch}?key=APIKey&token=APIToken' \
--header 'Accept: application/json'
Success
Content type | Value |
---|---|
application/json |
PUT /1/members/{id}/savedSearches/{idSearch}
Update a saved search
string
The ID or username of the member
string
The ID of the saved search to delete
string
The new name for the saved search
string
The new search query
string
New position for saves search. top
, bottom
, or a positive float.
1 2 3