---
title: "Remove Member from Team"
slug: "remove-member-from-team"
updated: 2026-06-08T12:46:40Z
published: 2026-06-08T12:46:40Z
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Remove Member from Team

Post/api/v1/teams.removeMember

Removes a member from a team.

Permission required: `edit-team-member`

Header parametersX-Auth-TokenstringRequired

The `authToken` of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-IdstringRequired

The `userId` of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ

Body parameters<select class='api-response-data' aria-label='Media type'><option value='60e2bbaa-14ae-41b4-9811-cf3fd6668e24'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='623fb16f-06c5-43dd-98ee-28671d93ead0'>Example</option>
</select>Example

```json
{
  "teamId": "63f3efc4b000b6b6d86704b2",
  "userId": "rYhzFRd2QZjNwAAXX",
  "rooms": [
    "JKa7R9zu2DinBhBN9"
  ]
}
```

object  teamIdstring    Required

Enter the team ID. Alternatively, enter the `teamName` parameter and provide the team's name as the value.

userIdstring    Required

The user ID to remove from the team.

rooms Array of string   

The rooms (IDs) from which the user should be removed.

string    

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='863c80bc-6d5a-49d9-95f8-e48dcb75f12c'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='c76d61ab-c3e4-4be1-91bd-d46e8ba3a073'>Success</option>
</select>Success

```json
{
  "success": true
}
```

object  successboolean    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='058f31fa-208d-4c84-bc63-fb72afc22c44'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='456bce75-28cb-492d-bd8d-907eb51d122f'>Authorization Error</option>
</select>Authorization Error

```json
{
  "status": "error",
  "message": "You must be logged in to do this."
}
```

object  statusstring    
messagestring