# group_activate

Activates a specific group for the bot — for example, to gain build rights on a parcel.

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

*This command also has an older alias:* `*activate_group*`*.*

# 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_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 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 to activate |

### Special values for `groupuuid`:

| Value | Description |
|-------|-------------|
| `LAND` | Sets active group to the **current parcel’s group** (useful to gain rez/build rights) |
| `00000000-0000-0000-0000-000000000000` | Removes active group (sets to none) |


:::info
**Note:** The bot must already be a member of the group to activate it.

:::

## 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 |

# Examples

### 1. Activate the group that matches the current parcel’s group

Used to automatically gain rez/build rights.

```csharp
smartbotsAPI("group_activate", [
  "groupuuid", "LAND"
]);
```

Equivalent HTTP request:

```
action=activate_group&groupuuid=LAND
```


---

### 2. Remove the active group (set to none)

```csharp
smartbotsAPI("group_activate", [
  "groupuuid", "00000000-0000-0000-0000-000000000000"
]);
```

Equivalent HTTP request:

```
action=group_activate&groupuuid=00000000-0000-0000-0000-000000000000
```