Commands › Groups
listgroups
Groups the bot belongs to (ids and names)
Usage
curl -X POST "https://api.lifebots.cloud/api/bot.html" \
-H "Content-Type: application/json" \
-d '{
"action": "listgroups",
"apikey": "YOUR_API_KEY",
"botname": "Joe Resident",
"secret": "bot-secret-123",
"dataType": "json"
}' Every request also needs apikey, botname and secret — see Authentication.
Parameters
None besides authentication.
Returns
| Field | Type | Description |
|---|---|---|
groups | string | One "uuid;name" line per group, separated by newlines — not an array. |
Example response
{
"result": "OK",
"groups": "b3f87fed-0470-4a7e-b035-100000000000;My Group\nd5f87fed-0470-4a7e-b035-100000000002;Builders"
} With dataType=json. A failure has result: "FAIL" and the reason in resulttext — see Responses & errors.