Skip to content
Clan LabsDocs
API referenceWebsite Open dashboard
Get startedDashboardDiscord botRoblox & Open CloudTroubleshooting
Documentation
Overview
  • Introduction
  • What is Clan Labs?
  • Core concepts
  • Requirements
  • Plans and availability
  • Quick start
Getting Started
  • Create or sign in
  • Add the Discord bot
  • Start setup with /setup
  • Select a Discord server
  • Connect a Roblox community
  • Confirm ownership
  • Choose a subscription
  • Configure Open Cloud
  • Complete setup
  • Recommended next steps
Setup Guides
  • Discord bot permissions
  • Roblox community connection
  • Roblox Open Cloud
  • Verification
  • Group and rank binds
  • Community permissions
  • Experience
  • Quotas
  • Welcome messages
  • Audit-log delivery
  • Events
  • Subscriptions
  • API keys
  • Divisions
Feature Guides
  • Member management
  • Profiles
  • Linked Roblox accounts
  • Experience and quotas
  • Ranks and group binds
  • Warnings
  • Suspensions
  • Blacklists
  • Medals and qualifications
  • Events and attendance
  • Audit logs and rollback
  • Analytics
  • Community permissions
  • Discord commands and actions
  • Pending join reviews
  • Custom bot branding
  • Discord server transfers
  • Privacy and account controls
  • Subscriptions and billing
Troubleshooting
  • Troubleshooting overview
  • Discord server is missing
  • Roblox community not found
  • Ownership cannot be confirmed
  • Bot permissions are missing
  • Discord role does not update
  • Role is above the bot
  • Verification fails
  • Open Cloud errors
  • Rank change fails
  • Profile does not sync
  • Command is unavailable
  • Action is not permitted
  • Subscription access is missing
  • Temporary service problem
API referenceClan Labs websiteOpen dashboard Support
Overview
  • Introduction
  • What is Clan Labs?
  • Core concepts
  • Requirements
  • Plans and availability
  • Quick start
Getting Started
  • Create or sign in
  • Add the Discord bot
  • Start setup with /setup
  • Select a Discord server
  • Connect a Roblox community
  • Confirm ownership
  • Choose a subscription
  • Configure Open Cloud
  • Complete setup
  • Recommended next steps
Setup Guides
  • Discord bot permissions
  • Roblox community connection
  • Roblox Open Cloud
  • Verification
  • Group and rank binds
  • Community permissions
  • Experience
  • Quotas
  • Welcome messages
  • Audit-log delivery
  • Events
  • Subscriptions
  • API keys
  • Divisions
Feature Guides
  • Member management
  • Profiles
  • Linked Roblox accounts
  • Experience and quotas
  • Ranks and group binds
  • Warnings
  • Suspensions
  • Blacklists
  • Medals and qualifications
  • Events and attendance
  • Audit logs and rollback
  • Analytics
  • Community permissions
  • Discord commands and actions
  • Pending join reviews
  • Custom bot branding
  • Discord server transfers
  • Privacy and account controls
  • Subscriptions and billing
Troubleshooting
  • Troubleshooting overview
  • Discord server is missing
  • Roblox community not found
  • Ownership cannot be confirmed
  • Bot permissions are missing
  • Discord role does not update
  • Role is above the bot
  • Verification fails
  • Open Cloud errors
  • Rank change fails
  • Profile does not sync
  • Command is unavailable
  • Action is not permitted
  • Subscription access is missing
  • Temporary service problem
  1. Docs
  2. /
  3. Troubleshooting
Troubleshooting

A Roblox rank change fails

Diagnose Clan Labs promote, demote, set-rank, suspension, and API rank failures safely.

Last updated 3 September 2026

Symptom

/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

  1. Open the target’s public Roblox group membership and note the current rank.
  2. Read the complete Clan Labs response, including whether data changed.
  3. Check Open Cloud status and group ID.
  4. Verify your community level and whether the target is officer-level.
  5. Review blacklist and suspension state.
  6. 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.

PreviousOpen Cloud errorsNext Profile does not sync
On this page
  1. Symptom
  2. Most likely causes
  3. Diagnostic checks
  4. Resolution
  5. When to retry
  6. Contact support
  7. Include this information