Get Bot Status

GET/bots/{bot_id}/status

Live status from the running bot. Fails with COMMAND_FAILED if the bot is offline.

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/status" \
  -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"
  },
  "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.