group_role_activate

Changes the bot’s active group tag/title to the specified role UUID.

// See "LSL Helper Functions" page for this function
smartbotsAPI("group_role_activate", [
  "groupuuid", "0b65a122-8f77-64fe-5b2a-225d4c490d9c",
  "roleuuid", "00000000-0000-0000-0000-000000000000"
]);

Variables

The following table shows input values (you send them with the API call) and returned output values.

Input basic parameters

Variable	Required	Description
action	yes	= group_role_activate
apikey	yes	Your personal developer's API key
botname	yes	Your bot’s SL login
secret	yes	Bot access code of your bot
dataType	optional	Set to `"json"` to get a JSON reply instead of URL-encoded string
custom	optional	Custom data (string) to be passed back to caller script. This value will be returned in the HTTP response

Input

Variable	Required	Description
groupuuid	yes	UUID of the group
roleuuid	yes	UUID of the role to activate (use `00000000-0000-0000-0000-000000000000` for “Everyone”)

Output

(To be received in http_response LSL event — see docs for details)

Variable	Description
result	`OK`— command completed successfully `FAIL` — command failed
resulttext	Detailed reason for the failure
custom	The value from input `"custom"` parameter

Example

Activate the “Everyone” group role tag:

// See "LSL Helper Functions" page for this function
smartbotsAPI("group_role_activate", [
  "groupuuid", "0b65a122-8f77-64fe-5b2a-225d4c490d9c",
  "roleuuid", "00000000-0000-0000-0000-000000000000"
]);