API Reference › Registered Groups
List Roles
GET
/groups/{group_id}/rolesRoles in the group, fetched live from Second Life. Use the ids for invites and role changes.
Scoperead:groups
Groups the user registered on LifeBots — on their own bot or a SharedBot — acted on through the bot that runs each group. Commands fail with GROUP_NOT_ACTIVE unless the group's status is running. For any group the user's own bot is in, registered or not, use Bots — Group Moderation.
Usage
curl "https://api.lifebots.cloud/api/v1/groups/$GROUP_ID/roles" \
-H "Authorization: Bearer $ACCESS_TOKEN"Path parameters
| Name | Type | Description |
|---|---|---|
group_id | UUID | Group UUID. |
Example response
{
"success": true,
"data": {
"result": "OK",
"action": "list_group_roles",
"roles": [
{
"id": "00000000-0000-0000-0000-000000000000",
"name": "Everyone"
},
{
"id": "c3e5a1f9-8b72-4d06-9e4a-1f2b3c4d5e6f",
"name": "Officers"
}
]
},
"meta": {
"timestamp": "2026-10-02T12:00:00.000Z",
"version": "1.0"
}
} Always check success; for commands the bot carries out, also check data.result. See Responses & errors.