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