group_powers

Lists what the bot is allowed to do in one group (Invite, Eject, SendNotices…), or in every group it is in when no group is given. Answers in one quick round trip — use it instead of listgroups_extended when you only need powers.

Usage

curl -X POST "https://api.lifebots.cloud/api/bot.html" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "group_powers",
  "apikey": "YOUR_API_KEY",
  "botname": "Joe Resident",
  "secret": "bot-secret-123",
  "groupuuid": "b3f87fed-0470-4a7e-b035-100000000000",
  "dataType": "json"
}'

Every request also needs apikey, botname and secret — see Authentication.

Parameters

Name	Required	Description
`groupuuid` UUID	no	Group UUID, or the exact name of a group the bot is in. Leave out for every group. Also accepted as: `group,` `groupId,` `groupName`

Returns

Field	Type	Description
`powers`	array	Power names, e.g. Invite, Eject, AssignMember, RemoveMember, SendNotices, JoinChat, ModerateChat, GroupBanAccess.
`permissions`	string	The same names, comma-separated.
`groups`	array	Without a group: one {uuid, name, powers, permissions} entry per group the bot is in.

Example response

{
  "result": "OK",
  "group_uuid": "b3f87fed-0470-4a7e-b035-100000000000",
  "group_name": "My Group",
  "powers": [
    "Invite",
    "Eject",
    "AssignMember",
    "SendNotices",
    "ReceiveNotices",
    "JoinChat"
  ],
  "permissions": "Invite, Eject, AssignMember, SendNotices, ReceiveNotices, JoinChat"
}

With dataType=json. A failure has result: "FAIL" and the reason in resulttext — see Responses & errors.

Good to know

Fails "Bot is not in this group" when the bot is not a member.
These are the bot's combined powers from all its roles in the group. Changes made in Second Life show up on the next call.