Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/N3XT3R1337/RiftCE/llms.txt

Use this file to discover all available pages before exploring further.

Custom fields let you attach arbitrary key-value string data to any account. This is useful for tracking notes, external IDs, workflow status, or any metadata you want to associate with an account that does not fit a built-in property. All endpoints on this page — including /setalias, /setdescription, and /setgroup — require the WebServerAllowEditing permission, which is disabled by default. Permission required for all endpoints on this page: WebServerAllowEditing When WebServerAllowEditing is disabled, all endpoints on this page return:
{ "error": "Editing disabled" }
WebServerAllowEditing is off by default because it allows external scripts to modify account data. Enable it only for trusted local automations.

GET /setalias

Sets the display-name alias for an account. When an alias is set, the Rift CE UI shows it instead of the Roblox username.

Parameters

Account
string
required
The Roblox username of the account to update.
Alias
string
required
The new alias value. Pass an empty string to clear the alias.

Response

success
boolean
true on success.
curl -H "X-Rift-Password: yourpassword" \
  "http://localhost:7963/setalias?Account=BuilderBob&Alias=Bob"

GET /setdescription

Sets the free-text description note on an account.

Parameters

Account
string
required
The Roblox username of the account to update.
Description
string
required
The new description value. Pass an empty string to clear the description.

Response

success
boolean
true on success.
curl -H "X-Rift-Password: yourpassword" \
  "http://localhost:7963/setdescription?Account=BuilderBob&Description=Main+farming+account"

GET /setgroup

Assigns an account to a named group.

Parameters

Account
string
required
The Roblox username of the account to update.
Group
string
required
The group name to assign. Pass an empty string to remove the account from its current group.

Response

success
boolean
true on success.
curl -H "X-Rift-Password: yourpassword" \
  "http://localhost:7963/setgroup?Account=BuilderBob&Group=Mains"

GET /getfield

Reads one or all custom fields from an account.
  • With Field: returns the value of that single field.
  • Without Field: returns the entire Fields dictionary for the account.

Parameters

Account
string
required
The Roblox username of the account to read from.
Field
string
The key of the custom field to retrieve. Omit this parameter to return all fields at once.

Response (single field)

field
string
The key name of the field that was requested.
value
string
The stored value. Returns an empty string if the key exists but has no value, or if the key has not been set.

Response (all fields)

Returns the Fields dictionary object directly — an object where each key is a field name and each value is its stored string.

Examples

curl -H "X-Rift-Password: yourpassword" \
  "http://localhost:7963/getfield?Account=BuilderBob&Field=proxy"

GET /setfield

Creates or overwrites a custom field on an account.

Parameters

Account
string
required
The Roblox username of the account to update.
Field
string
required
The key name of the custom field. Must not be empty — a missing or empty Field returns 400 Bad Request.
Value
string
required
The string value to store. Pass an empty string to store an empty value (different from removing the field).

Response

success
boolean
true on success.
curl -H "X-Rift-Password: yourpassword" \
  "http://localhost:7963/setfield?Account=BuilderBob&Field=proxy&Value=192.168.1.10:8080"

GET /removefield

Deletes a custom field from an account. The changes are saved to disk immediately.

Parameters

Account
string
required
The Roblox username of the account to update.
Field
string
required
The key name of the custom field to remove. Must not be empty — a missing or empty Field returns 400 Bad Request.

Response

success
boolean
true on success. Returned even if the key did not previously exist.
curl -H "X-Rift-Password: yourpassword" \
  "http://localhost:7963/removefield?Account=BuilderBob&Field=proxy"

Build docs developers (and LLMs) love