Invite

POST/bots/{bot_id}/groups/{group_id}/invite

Invite an avatar. Each avatar can be invited to the same group once every 5 minutes.

Act on any Second Life group the bot belongs to, whether or not the group is registered on LifeBots. Second Life enforces group powers: the bot needs the Invite, Eject or Assign Members ability, or the action has no effect. Group, role and avatar ids must be full UUIDs.

Usage

curl -X POST "https://api.lifebots.cloud/api/v1/bots/$BOT_ID/groups/$GROUP_ID/invite" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "avatar": "7d1d5c58-2a8f-4c3e-9b11-0a6e5f2c9e41",
    "roleuuid": "c3e5a1f9-8b72-4d06-9e4a-1f2b3c4d5e6f"
  }'

Path parameters

Name	Type	Description
`bot_id`	UUID	The bot's avatar UUID (agentId from GET /bots).
`group_id`	UUID	Group UUID.

Body (JSON)

Name	Type	Required	Description
`avatar`	UUID	yes	Avatar UUID.
`roleuuid`	UUID	no	Role to invite into. Omit for Everyone.
`nosafehub`	boolean	no	Refuse while the bot is in a Safe Hub.

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.