Add a Group Dynamically to Corrade's Configuration

13 March 2022

C11 - updated parameters.

7 October 2016

Release 9.135 - added.

addconfigurationgroup (Commands)
Type	Corrade progressive command
Command	`addconfigurationgroup`
Description	The `addconfigurationgroup` command can be used to add a group to Corrade's configuration.
Permissions	`system`
Parameters	`group`, `password`, `target`, `secret`, `permissions`, `notifications`
Last Changes	Release 9.135 - added.

The addconfigurationgroup command can be used to add a group to Corrade's configuration.

Command Required Parameters Required Corrade Permissions Example

addconfigurationgroup

group, password, target, secret, permissions, notifications

system

llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // Configure a new group.
            "command", "addconfigurationgroup",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            // The name or the UUID of a group.
            "target", "b2eaaaea-995a-01d3-10eb-712d3b2d68f4",
            "secret", llSHA1String("test"),
            // Corrade group permissions to set.
            "permissions", wasListToCSV(
                [
                    "group",
                    "notifications",
                    "talk",
                    "interact"
                ]
            ),
            // Corrade group notifications to set.
            "notifications", wasListToCSV(
                [
                    "alert",
                    "balance",
                    "inventory"
                ]
            ),
            "callback", wasURLEscape(URL)
        ]
    )
);

Notes

The added group has to exist on the connecting grid or Corrade will not find the group.
When the command is executed, Corrade adds the group to the configuration, the configuration file is updated and then Corrade will reload the configuration. As a consequence, adding a group with this command is permanent since the group configuration will be stored in Corrade's configuration file.
This command is added out of convenience because pulling the entire configuration (or even just a group configuration) would most likely exceed the 2KiB restriction imposed by http_request. To change individual settings for a group, you should consider accessing the configuration using the configuration command instead of removing and creating the entire group again.
To remove a group dynamically, you would use the removeconfigurationgroup command.