Commands › Movement
lookat
Turn to face an avatar or a point
Usage
curl -X POST "https://api.lifebots.cloud/api/bot.html" \
-H "Content-Type: application/json" \
-d '{
"action": "lookat",
"apikey": "YOUR_API_KEY",
"botname": "Joe Resident",
"secret": "bot-secret-123",
"target": "a2e76fcd-9360-4f6d-a924-000000000000",
"dataType": "json"
}' Every request also needs apikey, botname and secret — see Authentication.
Parameters
| Name | Required | Description |
|---|---|---|
targetstring | no | Avatar UUID or name. Required unless x, y and z are sent. Also accepted as: avatar, agent, slname, slkey |
xnumber | no | X coordinate to face. |
ynumber | no | Y coordinate. |
znumber | no | Z coordinate. |
nosafehubflag | no | Send 1 to refuse the command while the bot is in a Safe Hub region. |
Example response
{
"success": true,
"result": "OK",
"resulttext": "Looking at avatar a2e76fcd-9360-4f6d-a924-000000000000"
} With dataType=json. A failure has result: "FAIL" and the reason in resulttext — see Responses & errors.
Good to know
- If x, y and z are all sent, target is ignored.
- The avatar must be nearby, or the call fails "Avatar not found in nearby simulators".