A Roblox rank change fails
Diagnose Clan Labs promote, demote, set-rank, suspension, and API rank failures safely.
Last updatedSymptom
/promote, /demote, /changerank, a suspension, dashboard action, or API v2 rank request fails or returns Error - Rank check unavailable.
Most likely causes
- Open Cloud is missing, expired, or lacks group access.
- The target is not in the Roblox community or its rank changed.
- The destination is outside configured rank boundaries.
- Your permission is below the member or officer action requirement.
- A blacklist or active suspension blocks progression.
- Roblox rank state cannot currently be read safely.
- API rank management lacks Pro or
members.ranks.write.
Diagnostic checks
- Open the target’s public Roblox group membership and note the current rank.
- Read the complete Clan Labs response, including whether data changed.
- Check Open Cloud status and group ID.
- Verify your community level and whether the target is officer-level.
- Review blacklist and suspension state.
- For API requests, inspect the status, error code, scope, and feature details.
Resolution
Correct the specific permission, restriction, rank boundary, plan, scope, or Open Cloud problem. If Clan Labs says Error - Rank check unavailable, no data was changed; restore the dependency, refresh the Roblox rank, then submit once.
For a suspension failure, follow the response’s outcome. It can state that the member stayed on the previous rank, was queued for reconciliation, or needs manual review.
When to retry
Retry only after reading Roblox’s current rank. A timed-out external write may have succeeded, so never assume failure from a missing response alone.
Contact support
Contact Clan Labs support when all visible checks pass or Clan Labs reports that automatic rollback or reconciliation could not complete.
Include this information
Include community ID, target Roblox user ID, old and intended rank IDs or names, interface used, exact error/status, timestamp, and whether Roblox changed. Do not send API or Open Cloud keys.