List Bots

GET/bots

Paginated list of the user's bots, most recently seen first.

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?page=1&limit=25" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Path parameters

None.

Query parameters

Name	Type	Required	Description
`page`	integer	no	Page number, from 1.
`limit`	integer	no	Items per page, max 100.

Example response

{
  "success": true,
  "data": {
    "bots": [
      {
        "agentId": "7d1d5c58-2a8f-4c3e-9b11-0a6e5f2c9e41",
        "name": "Helper Bot",
        "status": "online",
        "expired": false,
        "expiryDate": "2026-11-01T00:00:00.000Z",
        "lastSeen": "2026-10-02T11:58:00.000Z",
        "currentRegion": "Sandbox Island",
        "botError": null
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 25,
      "total": 1,
      "totalPages": 1,
      "hasNext": false,
      "hasPrev": false
    }
  },
  "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.