Remove federated server

Removes a server

URL
Requires Auth
HTTP Method
/api/v1/federation/removeServerByUser
yes
POST
Payload
Argument
Example
Required
Description
serverName
my-server.rocket.chat
Required
The public server name.
Example payload
{
  "serverName": "my-server.rocket.chat"
}
Example Call
curl -H "X-Auth-Token: 9HqLlyZOugoStsXCUfD_0YdwnNnunAJF8V47U3QHXSq" \
     -H "X-User-Id: aobEdbYhXfu5hkeqG" \
     -X POST \
     -H "Content-type:application/json" \
     http://localhost:3000/api/v1/federation/removeServerByUser\
    -d '{"serverName": "my-server.rocket.chat"}'
Example Result
Success
{
  "success": true
}
Error
Any of the following errors can occur on the endpoint.
Authorization: Requires an authentication token for the request to be made.
Can't remove default server: This occurs when trying to remove a default server.
Authorization
Can't remove default server
 {
    "status": "error",
    "message": "You must be logged in to do this."
}
{
    "success": false,
    "error": "cannot-remove-default-server"
}
Version
Text
6.0.0
Added

URL	Requires Auth	HTTP Method
`/api/v1/federation/removeServerByUser`	`yes`	`POST`

Argument	Example	Required	Description
`serverName`	`my-server.rocket.chat`	Required	The public server name.

Version	Text
6.0.0	Added

Last modified 2mo ago