Take or Copy Object

Name: LifeBots
Rating: 4.8 (150 reviews)

POST/bots/{bot_id}/objects/{object_id}/take

Take an in-world object into the bot's inventory, or take a copy and leave it in place.

Scopebots:objects · older apps: write:bots

Usage

curl -X POST "https://api.lifebots.cloud/api/v1/bots/$BOT_ID/objects/$OBJECT_ID/take" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "take"
  }'

Path parameters

Name	Type	Description
`bot_id`	UUID	The bot's avatar UUID (agentId from GET /bots).
`object_id`	UUID	In-world object (prim) UUID.

Body (JSON)

Name	Type	Required	Description
`operation`	string	no	"take" (default) or "copy".
`folderId`	UUID	no	Folder to put it in. Omit for Objects.

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.