Commands › Avatars & friends
avatar_groups
Groups shown in an avatar's profile
Usage
curl -X POST "https://api.lifebots.cloud/api/bot.html" \
-H "Content-Type: application/json" \
-d '{
"action": "avatar_groups",
"apikey": "YOUR_API_KEY",
"botname": "Joe Resident",
"secret": "bot-secret-123",
"avatar": "a2e76fcd-9360-4f6d-a924-000000000000",
"dataType": "json"
}' Every request also needs apikey, botname and secret — see Authentication.
Parameters
| Name | Required | Description |
|---|---|---|
avatarUUID | yes | Avatar UUID (names are not accepted). Also accepted as: slkey |
skipnamesstring | no | Comma-separated; leave out entries whose name contains any of these. |
matchnamesstring | no | Comma-separated; keep only entries whose name contains one of these. |
matchuuidstring | no | Comma-separated; keep only entries whose UUID contains one of these. |
Returns
| Field | Type | Description |
|---|---|---|
groups | string | One "uuid name" line per group, separated by newlines — not an array. |
total | integer | Count before the filters were applied. |
Example response
{
"result": "OK",
"total": 2,
"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.