find_objects

Name: LifeBots
Rating: 4.8 (150 reviews)

Find objects near the bot

Usage

curl -X POST "https://api.lifebots.cloud/api/bot.html" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "find_objects",
  "apikey": "YOUR_API_KEY",
  "botname": "Joe Resident",
  "secret": "bot-secret-123",
  "range": "30",
  "dataType": "json"
}'

Every request also needs apikey, botname and secret — see Authentication.

Parameters

Name	Required	Description
`range` number	no	Search radius in metres. Default: `200`
`limit` integer	no	Maximum results (up to 100). Default: `100`
`uuid` UUID	no	Look up one object instead of searching.
`root_only` flag	no	0 to include linked child prims. Default: `1`
`with_props` flag	no	0 to skip names and owners (faster). Default: `1`
`parent` UUID	no	With root_only=0: only children of this object.

Example response

{
  "result": "OK",
  "found": "1",
  "returned": "1",
  "objects": [
    {
      "UUID": "9f8e7d6c-5b4a-4321-8fed-000000000000",
      "LocalID": 1234567,
      "Distance": 4.2,
      "Position": {
        "x": 130.1,
        "y": 127.5,
        "z": 25.3
      },
      "Props": {
        "Name": "Tip Jar",
        "Description": "",
        "OwnerID": "a2e76fcd-9360-4f6d-a924-000000000000",
        "GroupID": "00000000-0000-0000-0000-000000000000",
        "TouchName": "Tip",
        "SitName": ""
      }
    }
  ]
}

With dataType=json. A failure has result: "FAIL" and the reason in resulttext — see Responses & errors.

Good to know

Searches the bot's current region only, nearest first; worn attachments are excluded.
Names can be empty the first time an object is seen — call again.