Commands › Avatars & friends
avatar_picks
Picks 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_picks",
"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 |
|---|---|---|
picks | string | One "uuid name" line per pick, separated by newlines. |
total | integer | Count before the filters were applied. |
Example response
{
"result": "OK",
"total": 1,
"picks": "f1e2d3c4-0000-4000-8000-000000000003 My Store"
} With dataType=json. A failure has result: "FAIL" and the reason in resulttext — see Responses & errors.