Skip to main content
Assign a room to a user. If RoomNumber is null or omitted, the API randomly selects an available room from the requested type.

​
Request

curl -X POST https://api.series.hr/hotel/assign-room \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "TargetUserId": "714760171",
    "RoomTypeId": "deluxe-suite",
    "RoomNumber": null
  }'

​
Body

​
TargetUserId
string
required
Roblox user ID or username to assign the room to.
​
RoomTypeId
string
required
The room type ID to assign from.
​
RoomNumber
string | null
Specific room number to assign, or null for a random available room.

​
Response

​
200
{
  "success": true,
  "data": {
    "WorkspaceId": "a7d5339a-5531-4336-99c6-6f3249c9ac20",
    "RoomNumber": "204",
    "Action": "assign",
    "Room": {
      "RoomNumber": "204",
      "TypeId": "deluxe-suite",
      "Floor": 2,
      "Status": "occupied"
    },
    "Rooms": []
  }
}

​
Status Codes

  • 200: Room assigned successfully
  • 400: Invalid input, no available rooms, or gamepass check failed
  • 401: API key is required or invalid
  • 403: Hotel module is disabled or workspace access is denied