Commands › Appearance & animation
wear
Wear an item — replacing the current outfit unless told to add
Usage
curl -X POST "https://api.lifebots.cloud/api/bot.html" \
-H "Content-Type: application/json" \
-d '{
"action": "wear",
"apikey": "YOUR_API_KEY",
"botname": "Joe Resident",
"secret": "bot-secret-123",
"uuid": "5d2d7a1d-0e8e-4f5d-a678-000000000000",
"wear": "add",
"dataType": "json"
}' Every request also needs apikey, botname and secret — see Authentication.
Parameters
| Name | Required | Description |
|---|---|---|
uuidUUID | yes | Inventory item UUID (not an asset UUID). Also accepted as: itemId |
wearstring | no | add to put it on top of what the bot is wearing. Anything else replaces the outfit. Default: replace Also accepted as: addToExisting |
Example response
{
"result": "OK",
"itemName": "Red Jacket",
"resulttext": "Successfully wore Red Jacket"
} With dataType=json. A failure has result: "FAIL" and the reason in resulttext — see Responses & errors.
Good to know
- Without wear=add the bot takes off ALL other clothing and attachments first. Body parts (shape, skin, hair, eyes) and RLV-locked items stay on.
- The item must already be loaded in the bot's inventory, or the call fails "Item not found".