Links
Comment on page

Delete a Team

Removes a team. Requires delete-team permission.
URL
Requires Auth
HTTP Method
/api/v1/teams.delete
yes
POST

Payload

Argument
Example
Required
Description
teamId teamName
ByehQjC44FwMeiLbX team1
Required
The team id. The team name.
roomsToRemove
["8dugqGhuRvCBLdZft"]
Optional
The rooms (ids) to delete along with team.

Example Call

curl -H "X-Auth-Token: 8h2mKAwxB3AQrFSjLVKMooJyjdCFaA7W45sWlHP8IzO" \
-H "X-User-Id: ew28FnZqipDpvKw3R" \
-H "Content-type: application/json" \
http://localhost:3000/api/v1/teams.delete \
-d '{ "teamId": "Isjsldk32sdkfA" }'

Example Result

{
"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.