Commands › Inventory
give_inventory
Give an item or a whole folder to an avatar
Usage
curl -X POST "https://api.lifebots.cloud/api/bot.html" \
-H "Content-Type: application/json" \
-d '{
"action": "give_inventory",
"apikey": "YOUR_API_KEY",
"botname": "Joe Resident",
"secret": "bot-secret-123",
"avatar": "a2e76fcd-9360-4f6d-a924-000000000000",
"object": "5d2d7a1d-0e8e-4f5d-a678-000000000000",
"dataType": "json"
}' Every request also needs apikey, botname and secret — see Authentication.
Parameters
| Name | Required | Description |
|---|---|---|
avatarUUID | yes | Recipient avatar UUID. |
objectUUID | yes | Item UUID or folder UUID. |
nosafehubflag | no | Send 1 to refuse the command while the bot is in a Safe Hub region. |
Example response
{
"success": true,
"result": "OK",
"resulttext": ""
} With dataType=json. A failure has result: "FAIL" and the reason in resulttext — see Responses & errors.
Good to know
- An item needs Transfer permission for the bot. The item must already be loaded in the bot's inventory; list the folder first if the bot has only just logged in.