Invite

POST/groups/{group_id}/invite

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

Groups the user registered on LifeBots — on their own bot or a SharedBot — acted on through the bot that runs each group. Commands fail with GROUP_NOT_ACTIVE unless the group's status is running. For any group the user's own bot is in, registered or not, use Bots — Group Moderation.

Usage

curl -X POST "https://api.lifebots.cloud/api/v1/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
`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.

Example response

{
  "success": true,
  "data": {
    "success": true,
    "result": "OK",
    "resulttext": "Group invite sent",
    "action": "group_invite"
  },
  "meta": {
    "timestamp": "2026-10-02T12:00:00.000Z",
    "version": "1.0"
  }
}

A repeat invite within 5 minutes answers result "FAIL" with resulttext "Invite on cooldown. Ns remaining." inside a success: true envelope.

Always check success; for commands the bot carries out, also check data.result. See Responses & errors.