Commands › Appearance & animation
wear_outfit
Put on a saved outfit by name
Usage
curl -X POST "https://api.lifebots.cloud/api/bot.html" \
-H "Content-Type: application/json" \
-d '{
"action": "wear_outfit",
"apikey": "YOUR_API_KEY",
"botname": "Joe Resident",
"secret": "bot-secret-123",
"outfitName": "Casual",
"dataType": "json"
}' Every request also needs apikey, botname and secret — see Authentication.
Parameters
| Name | Required | Description |
|---|---|---|
outfitNamestring | yes | Outfit folder name in My Outfits (exact match first, then partial). Also accepted as: outfit_name |
Example response
{
"result": "OK",
"resulttext": "Wore 8 items from folder",
"totalItems": 8
} With dataType=json. A failure has result: "FAIL" and the reason in resulttext — see Responses & errors.
Good to know
- If the name is empty or missing, the FIRST outfit is worn. Always send a name.
- Replaces the current outfit. On failure the response lists availableOutfits.