Links

Get Team's Members

Lists the members of a team
URL
Requires Auth
HTTP Method
/api/v1/teams.members
yes
GET

Query Parameters

Argument
Example
Required
Description
teamId teamName
ByehQjC44FwMeiLbX team1
Required
The team id. The team name.
name
Example Name
Optional
The user's name (search filter).
username
some.username
Optional
The username (search filter).
status
["online", "away", "busy"]
Optional
The user's status (search filter).

Example Call

curl -H 'X-Auth-Token: _2u_4MzRroRcnqc59GYUY_Kwgr9HgtZ9HCKn-2aIvMJ' \
-H 'X-User-Id: FL2fZL4ERhwA3gWiS' \
-H "Content-type: application/json" \
'http://localhost:3000/api/v1/teams.members?teamName=team1&status[]=online&status=away&status=busy'

Example Result

{
"members": [
{
"user": {
"_id": "FL2fZL4ERhwA3gWiS",
"username": "some.username",
"name": "Example Name",
"status": "online"
},
"roles": [
"owner"
],
"createdBy": {
"_id": "FL2fZL4ERhwA3gWiS",
"username": "some.username"
},
"createdAt": "2021-04-19T23:09:15.109Z"
}
],
"total": 3,
"count": 1,
"offset": 0,
"success": true
}
Last modified 1yr ago
Deprecation for cloud services and apps is now extended to November 20, 2023. Rocket.Chat versions receive support for six months after release.