group_info_2

Returns the information about Second Life group, along with roles and titles.

// See "LSL Helper Functions" page for this function

smartbotsAPI("group_info_2", [
  "groupuuid", "0b65a122-8f77-64fe-5b2a-225d4c490d9c"
]);

Variables

The following table shows input values (you send them with the API call) and returned output values.

Input basic parameters

Variable	Required	Description
action	yes	= group_list2
apikey	yes	Your personal developer's API key
botname	yes	Your bot's SL login
secret	yes	Bot access code of your bot
dataType	optional	Set to "json" to get JSON reply instead of URL-encoded string
custom	optional	The custom data (string) to be passed back to caller script. This value will be returned back to the caller in HTTP response

Input

Variable	Required	Description
groupuuid	yes	The group UUID.

Output

(To be received in *http_response* LSL event, see docs for details)

Variable	Description
result	OK - command completed successfully FAIL - command failed
resulttext	Detailed reason for the failure
custom	The value from input "custom" parameter. See above
info	JSON object containing the group info (see below)

Return value

This command returns complex data and is only available when requesting JSON output (dataType=json).

info field contains:

interface group_info_2.Info {
	// Group UUID
	uuid: UUID;
 	// Group name
	name: string;

 	// UUID of the founder resident
	founder: UUID;
 	// UUID of the group image
	insignia: UUID;
 	// Group description
	charter: string;

	// The number of members in the group
	members: number;
 
 	// The list of the group roles (see interface below)
	roles: GroupRole[]; 
 	// The list of roles titles available to bot (see below)
	titles: GroupTitle[];
 	// Current title
	memberTitle: string;

 	// Is group open to join
	open: boolean;
 	// Join group fee
	fee: number;
 	// Is group mature
	mature: boolean;

	// Is bot a member of this group
	isMember: boolean;
}

interface GroupRole {
	// Role UUID 
	uuid: UUID;
 	// Role name
	name: string;
 	// Role descriptiom
	description: string;
 	// Role title (tag)
	title: string;
	// List of role powers in a group ('JoinChat', 'AllowRez') 
	powers: string[];
}
 
interface GroupTitle {
	// Related role UUID
	role: UUID;
 	// Title (tag)
	title: string;
 	// Is this title currently active for bot avatar
	selected: boolean;
}

Check group permissions page for a full list of permissions.

Example

Example output:

{
  "members": 8202,
  "mature": false,
  "isMember": true,
  "open": true,
  "memberTitle": "Smart VIP Partner",
  "name": "SmartBots: group invitation bots",
  "roles": [
    {
      "description": "These are the owners of the group.  They always have FULL POWER over the group.",
      "uuid": "044ad014-7298-eb70-0945-85d6df01f154",
      "title": "SmartBots CEO",
      "name": "Owners",
      "powers": [
        "Invite",
        "Eject",
        "ChangeOptions",
        "CreateRole",
        "DeleteRole",
        "RoleProperties",
        "AssignMemberLimited",
        "AssignMember",
        "RemoveMember",
        "ChangeActions",
        "ChangeIdentity",
        "LandDeed",
        "LandRelease",
        "LandSetSale",
        "LandDivideJoin",
        "JoinChat",
        "FindPlaces",
        "LandChangeIdentity",
        "SetLandingPoint",
        "ChangeMedia",
        "LandEdit",
        "LandOptions",
        "AllowEditLand",
        "AllowFly",
        "AllowRez",
        "AllowLandmark",
        "AllowVoiceChat",
        "AllowSetHome",
        "LandManageAllowed",
        "LandManageBanned",
        "LandManagePasses",
        "LandEjectAndFreeze",
        "ReturnGroupSet",
        "ReturnNonGroup",
        "LandGardening",
        "DeedObject",
        "ModerateChat",
        "ObjectManipulate",
        "ObjectSetForSale",
        "Accountable",
        "HostEvent",
        "SendNotices",
        "ReceiveNotices",
        "StartProposal",
        "VoteOnProposal",
        "MemberVisible",
        "ReturnGroupOwned",
        "ExperienceAdmin",
        "ExperienceCreator",
        "GroupBanAccess"
      ]
    },
    {
      "uuid": "10d7e54f-7c52-8f0e-7ad8-7e0059664cd0",
      "description": "",
      "title": "SmartBots",
      "powers": [
        "Invite",
        "Eject",
        "AssignMemberLimited",
        "RemoveMember",
        "ModerateChat",
        "SendNotices",
        "MemberVisible"
      ],
      "name": "SmartBots"
    },
    {
      "powers": [
        "Eject",
        "AssignMemberLimited",
        "RemoveMember",
        "ModerateChat",
        "SendNotices",
        "MemberVisible"
      ],
      "name": "Senior Support",
      "title": "+SmartBots Support+",
      "uuid": "73d95c88-1a38-5227-234d-76ae665bc50f",
      "description": ""
    },
    {
      "uuid": "7aeed271-efa4-b732-526f-a5dbe98436c8",
      "description": "",
      "title": "SmartBots Support",
      "name": "Support Managers",
      "powers": [
        "Eject",
        "ModerateChat",
        "SendNotices",
        "MemberVisible"
      ]
    },
    {
      "description": "",
      "uuid": "aebb8d51-c3b6-74cb-cc66-9c30584b5542",
      "title": "Alive SmartBot",
      "name": "Alive Bots",
      "powers": [
        "MemberVisible"
      ]
    },
    {
      "powers": [
        "Invite"
      ],
      "name": "Support Bot",
      "title": "Right-click & IM me!",
      "description": "",
      "uuid": "aef5b7a6-f0c4-b847-5953-1d490f0b3485"
    },
    {
      "name": "Developers",
      "powers": [
        "MemberVisible"
      ],
      "title": "SmartBots Developer",
      "description": "",
      "uuid": "ba093feb-680a-a321-086a-c0343a96f960"
    },
    {
      "name": "Barkeeper Bot",
      "powers": [],
      "title": "Touch me for a drink",
      "uuid": "d3ddc55d-0152-d735-57f6-62eb692237f3",
      "description": ""
    },
    {
      "name": "Personal bot",
      "powers": [],
      "description": "",
      "uuid": "eaa86b3b-1408-fb4f-3118-7dadabf65fec",
      "title": "I'm Personal Bot"
    },
    {
      "powers": [
        "Invite",
        "JoinChat",
        "ReceiveNotices"
      ],
      "name": "Everyone",
      "title": "Smart VIP Partner",
      "uuid": "00000000-0000-0000-0000-000000000000",
      "description": "Everyone in the group is in the everyone role."
    }
  ],
  "insignia": "bf41fd15-3edb-c1d0-d4d9-fe9fbe5a96e6",
  "titles": [
    {
      "role": "00000000-0000-0000-0000-000000000000",
      "selected": true,
      "title": "Smart VIP Partner"
    }
  ],
  "founder": "cd93067e-7c4e-41c0-ba91-be01f4bafe35",
  "charter": "Direct group inviter  just for L$79 per week! Plus chat manager, notice sender and a lot of unique features:\n\n- chat control using web browser\n- automatic scheduled notices\n- spamless (respects parcel borders)\n- only 1-prim object is required on your parcel\n\nVisit us at http://www.smartbots2life.com\nOffice: DuoLife/204/98/32",
  "uuid": "0b65a122-8f77-64fe-5b2a-225d4c490d9c",
  "fee": 0
}