# group_role_activate

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

```csharp
// 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](/doc/developers-api-key-tw8bQj4LSJ) |
| botname  | yes      | Your bot’s SL login |
| secret   | yes      | [Bot access code](https://www.mysmartbots.com/docs/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*](/doc/doing-http-api-calls-c6FSEMF7bP)*)*

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

# Example

Activate the “Everyone” group role tag:

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