self.add lists only members that need adding. Adding a previously added member has no effect. Adding no members (sending an empty members list) has no effect on the group, but still forces an update of the group configuration object in the feedback channel. This “trick” can be used to request a group’s current member configuration, similar to empty empty value assignments.

Group Add Actions

A member is added to an existing group with self.add. Add takes an argument object carrying a list of members to be added.

Group add argument objects:

Field Name	Type	Description
apply	Boolean	(Optional) apply tracks the value that was most recently assigned through the group. If such a value is on file, and if apply: true, that most recent value will be re-applied to the group after the self.add or self.remove action completes.
provision	Boolean	(Optional) Provisions a group when members change. Defaults to true.
members	List of member topics	(Required) List of members to add to the group.

Example

You add a member to an existing group using the self.add action of the group do topic. The following example adds a member to an existing group:

glp/0/{SID}/rq/grp/{Handle}/do

{
action: "self.add",
args: {
members: [ "glp/0/site-A/rq/dev/lon/b3/if/switch/3" ]
}
}