List Bot Groups (ids and names)

GET/bots/{bot_id}/groups/simple

Compact id and name list of the bot's groups.

Scopeany bots:* scope · older apps: read:bots or write:bots

Find the user's bots, read their state, and start or stop them. Any bots:* scope grants the read endpoints here, since an app must be able to discover the bots it is allowed to control.

Usage

1
2

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

Path parameters

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

Example response

{
  "success": true,
  "data": {
    "result": "OK",
    "action": "listgroups",
    "groups": [
      {
        "id": "a1b2c3d4-0000-4000-8000-000000000001",
        "name": "My Group"
      }
    ]
  },
  "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.