API ReferenceRoblox
Set Rank
Set a Roblox user's rank to a specific role ID in the group.
POST /api/roblox/setrankSets a Roblox user to a specific 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/setrank \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"userId": 123456789,
"rankId": 100,
"reason": "Promoted to moderator"
}'Response
200 OK
{
"success": true,
"oldRank": 10,
"newRank": 100,
"username": "Builderman"
}Prop
Type
Errors
| Status | Meaning |
|---|---|
400 | Invalid request (bad userId or rankId, rank does not exist, user not in group). |
401 | Missing API key. |
403 | Invalid API key or monthly rank limit exceeded. |
404 | Workspace not found. |
500 | Internal server error. |
Was this page helpful?