RankGun logoRankGun

Demote User

Demote a Roblox user by one rank in the group.

POST /api/roblox/demote

Demotes a Roblox user by one rank in your workspace's configured group. Counts against your monthly rank action quota.

Headers

Prop

Type

Request Body

Prop

Type

curl -X POST https://api.rankgun.works/api/roblox/demote \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": 123456789,
    "reason": "Inactive for 30 days"
  }'

Response

200 OK

{
  "success": true,
  "oldRank": 20,
  "newRank": 10,
  "username": "Builderman"
}

Prop

Type

Errors

StatusMeaning
400Invalid request (bad userId, user not in group, already at lowest rank).
401Missing API key.
403Invalid API key or monthly rank limit exceeded.
404Workspace not found.
500Internal server error.
Was this page helpful?

On this page