Group Details

GET/groups/{group_id}

Stored details of one registered group: status, expiry, member count and the bot that runs it.

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

1
2

curl "https://api.lifebots.cloud/api/v1/groups/$GROUP_ID" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Path parameters

Name	Type	Description
`group_id`	UUID	Group UUID.

Example response

{
  "success": true,
  "data": {
    "groupId": "a1b2c3d4-0000-4000-8000-000000000001",
    "groupName": "My Group",
    "groupDesc": "Welcome to My Group!",
    "groupImg": "c1d2e3f4-0000-4000-8000-000000000004",
    "memberCount": 120,
    "status": "running",
    "expiryDate": "2026-11-01T00:00:00.000Z",
    "expired": false,
    "groupType": "personal",
    "groupPowers": [
      "Invite",
      "Eject",
      "SendNotices",
      "ReceiveNotices",
      "JoinChat"
    ],
    "agentId": "7d1d5c58-2a8f-4c3e-9b11-0a6e5f2c9e41",
    "isBotInGroup": true,
    "createdAt": "2025-07-07T19:59:37.656Z",
    "updatedAt": "2026-09-30T08:12:00.000Z",
    "lastRefreshed": "2026-09-30T08:12:00.000Z"
  },
  "meta": {
    "timestamp": "2026-10-02T12:00:00.000Z",
    "version": "1.0"
  }
}

agentId is the bot running the group. groupPowers is a stored snapshot (see lastRefreshed). For live powers of a group on the user's own bot, use GET /bots/{bot_id}/groups/{group_id}/powers.

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