API Reference › Bots — Objects & Nearby
Touch Object
POST
/bots/{bot_id}/touchTouch an object by UUID, or the object nearest a point.
Usage
curl -X POST "https://api.lifebots.cloud/api/v1/bots/$BOT_ID/touch" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"target": "b2f4e0a7-61c3-4d8e-a5f9-3c7e2d1b0a96"
}'Path parameters
| Name | Type | Description |
|---|---|---|
bot_id | UUID | The bot's avatar UUID (agentId from GET /bots). |
Body (JSON)
| Name | Type | Required | Description |
|---|---|---|---|
target | UUID | no | Object to touch. Required unless x, y, z are sent. |
x | number | no | X coordinate. |
y | number | no | Y coordinate. |
z | number | no | Z coordinate. |
precision | number | no | How close to the point the object must be, in metres. |
Example response
{
"success": true,
"data": {
"result": "OK"
},
"meta": {
"timestamp": "2026-10-02T12:00:00.000Z",
"version": "1.0"
}
} Always check success; for commands the bot carries out, also check data.result. See Responses & errors.