Skip to main content
POST
Demote User
Requires Premium or Enterprise subscription

Overview

Demotes a user to the next lower rank in the linked Roblox group. The user does not need to be a workspace member - they only need to be a member of the Roblox group. For workspace members:
  • Action is logged to ranking history, audit log, and disciplinary records
  • Workspace member data is updated
  • Related ranking suggestions are cleared
For non-workspace members (group members only):
  • Action is logged to ranking history and audit log only
  • No disciplinary record is created
  • All logs indicate the action was performed via API

Path Parameters

string
required
The Roblox user ID to demote

Request Body

string
Optional reason/comment for the demotion. This will be logged in ranking history and disciplinary records.

Response

boolean
Whether the request was successful
object

Example

Response Example

Error Responses

Side Effects

When a user is demoted, the following actions occur automatically: For all users (workspace members and group-only members):
  1. Roblox Group Update - User’s rank in the Roblox group is updated
  2. Ranking History - Entry logged with timestamp, author, and comment
  3. Audit Log - Action logged with workspace member or group-only indicator
Additionally for workspace members only: 4. Workspace Data Update - User’s CurrentRank and CurrentRole are updated 5. Disciplinary Log - Record added to user’s disciplinary file 6. Suggestions Cleared - Pending demotion suggestions for the user are removed

Rate Limit

50 requests per second per API key

Authorizations

apikey
string
header
required

Pass your API key in the apikey header. Alternatively, the x-api-key header is also accepted.

Path Parameters

userId
string
required

The Roblox user ID to demote

Body

application/json
comment
string

Optional reason/comment for the demotion

Response

User demoted