RankGun logoRankGun

Promote User

Promote a Roblox user by one rank in the group.

POST /api/roblox/promote

Promotes 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/promote \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": 123456789,
    "reason": "Passed training"
  }'

Response

200 OK

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

Prop

Type

Errors

StatusMeaning
400Invalid request (bad userId, user not in group, already at top 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