# eject

Ejects residents from the group.

```none
// HTTP request to:
// https://api.mysmartbots.com/api/simple.html
// with action=eject and required parameters
```

# Input

| Variable | Required | Description |
|----------|----------|-------------|
| `action` | Yes      | Must be `"eject"`. |
| `apikey` | Yes      | Your personal developer's API key. |
| `secret` | Yes      | Security code of the group you are using. |
| `secret_sha1` | *Optional* | Same as `secret` but hashed with SHA1. |
| `group`  | Yes      | The group name (must be listed with SmartBots!). |
| `slkey`  | Yes      | The UUID of the resident. |
| `message` | *Optional* | A message to send along with the ejection. Cannot contain international characters. |

# Output (Plain text)

| `"OK"` | Command completed successfully. |
|------|---------------------------------|
| *anything else* | Request failed. The failure reason is returned in plain text. |


:::note
If you are using a custom role (other than "Everyone"), you need additional abilities for your bot. Read the documentation for details.

:::

# Example

## Basic

```none
POST https://api.mysmartbots.com/api/simple.html

action=eject

apikey=YOUR_API_KEY

secret=YOUR_GROUP_SECRET

group=My Group Name

slkey=00000000-0000-0000-0000-000000000000

message=You have been removed.
```

## CURL

```bash
curl -X POST https://api.mysmartbots.com/api/simple.html \
  -d "action=eject" \
  -d "apikey=YOUR_API_KEY" \
  -d "secret=YOUR_GROUP_SECRET" \
  -d "group=My Group Name" \
  -d "slkey=00000000-0000-0000-0000-000000000000" \
  -d "message=You have been removed."
```

## LSL

```csharp
touch_start(integer num) {
    string params = llDumpList2String([
        "action="  + "eject",
        "apikey="  + llEscapeURL(yourApiKey),
        "secret="  + llEscapeURL(groupSecretCode),
        "group="   + llEscapeURL("My Group Name"),
        "slkey="   + (string)llDetectedKey(0),
        "message=" + llEscapeURL("You have been removed.")],
        "&");

    llHTTPRequest(
        "https://api.mysmartbots.com/api/simple.html",
        [HTTP_METHOD,"POST"],
        params
    );
}
```