Commands › Region & estate
sim_return
Return objects across the region
Usage
curl -X POST "https://api.lifebots.cloud/api/bot.html" \
-H "Content-Type: application/json" \
-d '{
"action": "sim_return",
"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 | no | Only this avatar's objects. |
scriptedflag | no | 1 for scripted objects only. |
othersflag | no | 1 for objects on other people's land. |
all_estatesflag | no | 1 for every estate the bot manages. |
Example response
{
"success": true,
"result": "OK",
"resulttext": "Object return requested"
} With dataType=json. A failure has result: "FAIL" and the reason in resulttext — see Responses & errors.
Good to know
- What is returned without an avatar is up to Second Life. The bot must be an estate manager. Second Life enforces this; the call answers OK either way.