Promote User

Requires Premium or Enterprise subscription

Overview

Promotes a user to the next higher 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 promote

Request Body

string

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

Response

boolean

Whether the request was successful

object

Show properties

string

The Roblox user ID that was promoted

string

The action performed (promote)

number

The user’s previous rank number

string

The user’s previous role name

number

The user’s new rank number

string

The user’s new role name

string

The workspace ID

Example

curl -X POST https://api.series.hr/ranking/promote/714760171 \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"comment": "Passed training evaluation"}'

const response = await fetch('https://api.series.hr/ranking/promote/714760171', {
  method: 'POST',
  headers: {
    'apikey': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    comment: 'Passed training evaluation'
  })
});

const data = await response.json();

local HttpService = game:GetService("HttpService")

local response = HttpService:RequestAsync({
    Url = "https://api.series.hr/ranking/promote/714760171",
    Method = "POST",
    Headers = {
        ["apikey"] = "YOUR_API_KEY",
        ["Content-Type"] = "application/json"
    },
    Body = HttpService:JSONEncode({
        comment = "Passed training evaluation"
    })
})

local data = HttpService:JSONDecode(response.Body)

import requests

response = requests.post(
    'https://api.series.hr/ranking/promote/714760171',
    headers={
        'apikey': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={'comment': 'Passed training evaluation'}
)

data = response.json()

Response Example

{
  "success": true,
  "data": {
    "UserId": "714760171",
    "Action": "promote",
    "PreviousRank": 5,
    "PreviousRole": "Trainee",
    "NewRank": 20,
    "NewRole": "Junior Staff",
    "WorkspaceId": "a7d5339a-5531-4336-99c6-6f3249c9ac20"
  }
}

Error Responses

400 - Already at Highest Rank

{
  "success": false,
  "error": {
    "code": 400,
    "message": "Validation error: User is already at the highest rank"
  }
}

400 - Rank Limit Exceeded

{
  "success": false,
  "error": {
    "code": 400,
    "message": "Cannot promote beyond rank 100 (Max. Promotion Rank limit)"
  }
}

403 - Premium Required

{
  "success": false,
  "error": {
    "code": 403,
    "message": "Ranking management requires a Premium or Enterprise subscription"
  }
}

404 - User Not in Group

{
  "success": false,
  "error": {
    "code": 404,
    "message": "User is not a member of the group"
  }
}

429 - Rate Limit

{
  "success": false,
  "error": {
    "code": 429,
    "message": "Rate limit exceeded for ranking endpoints: 50 requests per second."
  }
}

Side Effects

When a user is promoted, the following actions occur automatically: For all users (workspace members and group-only members):

Roblox Group Update - User’s rank in the Roblox group is updated
Ranking History - Entry logged with timestamp, author, and comment
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 promotion suggestions for the user are removed

Rate Limit

50 requests per second per API key

Introduction & basics

Basic

Activity

Activity Credits

Sessions

Attendance

Game Moderation

Applications

Members

Time-Off

Hotel

Food & Beverage

Ranking

Flights

Tickets

Overview

Path Parameters

Request Body

Response

Example

Response Example

Error Responses

Side Effects

Rate Limit

​Overview

​Path Parameters

​Request Body

​Response

​Example

​Response Example

​Error Responses

​Side Effects

​Rate Limit

Overview

Path Parameters

Request Body

Response

Example

Response Example

Error Responses

Side Effects

Rate Limit