Eject a Group Member

22 October 2016

Release 9.140 - added the optional demote parameter.

21 December 2014

Release 7.34 - added group Corrade permission.

eject (Commands)
Type	Corrade progressive command
Command	`eject`
Description	The `eject` command can be used to eject an agent from a group.
Permissions	`group`
Parameters	`group`, `password`, `firstname`, `lastname` (or `agent` by UUID)
Last Changes	Release 7.34 - added `group` Corrade permission.

The eject command can be used to eject an agent from a group. It requires both the in-world power to eject as well as the in-world group power to remove members from roles in order to make sure that the member has been ejected.

Command	Required Parameters	Required Corrade Permissions	Required Group Abilities	Example
`eject`	`group`, `password`, `firstname`, `lastname` (or `agent` by UUID)	`group`	* `Membership→Eject Members from this Group` * `Roles→Remove Members from Roles`	llInstantMessage(CORRADE, wasKeyValueEncode( [ "command", "eject", "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), // or "agent", "69ce412b-dffc-436d-86ff-d788bfa66d9d" "firstname", "Corrade", "lastname", "Resident", ] ) );

Optional Parameter	Possible Value	Description
`demote`	`True` or `False`	In case `demote` is set to `False` then Corrade will fail to eject the avatar in case the avatar is part of any other role other than the `Everyone` role.

Notes

Avatars can only be ejected if and only if they are part of just the "Everyone" role. The eject command with the demote parameter set to True will handle demoting them before ejecting them. However, by passing demote to the eject command, Corrade will require the SecondLife group permission "Membership→Eject Members from this Group".
As per the previous point, in case the following error appears on the CasperTech interface:

then please make sure that the Membership→Eject Members from this Group SecondLife group permission is granted to your Corrade bot.