Skip to main content
PUT
/
v1
/
guilds
/
{guild_id}
/
room-settings
curl -X PUT https://hapi.7331.org/v1/guilds/987654321098765432/room-settings \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{"browser": "tor", "kiosk": true}'
{
  "browser": "tor",
  "proxy": "none",
  "start_url": "https://google.com",
  "kiosk": true,
  "allow_control_requests": true
}
Requires an active session cookie. The caller must be the guild owner, guild sponsor, or ADMIN+. Only provided fields are updated; omitted fields remain unchanged.
guild_id
integer
required
Discord snowflake ID of the guild.
browser
string
Browser type for the room VM (e.g. brave, tor).
proxy
string
Proxy region (e.g. us, eu, none).
start_url
string
Default URL opened when the room VM starts. Max 2000 characters.
kiosk
boolean
Whether to launch the browser in kiosk mode.
allow_control_requests
boolean
Whether users can request control of the VM.

Response

Returns the updated room settings object.
browser
string
Browser type for the room VM.
proxy
string
Proxy region.
start_url
string
Default URL opened when the room VM starts.
kiosk
boolean
Whether kiosk mode is enabled.
allow_control_requests
boolean
Whether control requests are allowed.
curl -X PUT https://hapi.7331.org/v1/guilds/987654321098765432/room-settings \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{"browser": "tor", "kiosk": true}'
{
  "browser": "tor",
  "proxy": "none",
  "start_url": "https://google.com",
  "kiosk": true,
  "allow_control_requests": true
}