Logout Bot

POST/bots/{bot_id}/logout

Start logging the bot out. Answers 202 with status "disconnecting"; poll GET /bots/{bot_id} until status is "offline". Answers 200 if the bot is already offline.

Scopebots:lifecycle · older apps: 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 -X POST "https://api.lifebots.cloud/api/v1/bots/$BOT_ID/logout" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Path parameters

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

Body

None — send an empty body.

Example response

{
  "success": true,
  "data": {
    "result": "OK",
    "status": "disconnecting",
    "message": "Logout started. Poll GET /bots/{bot_id} until status is offline."
  },
  "meta": {
    "timestamp": "2026-10-02T12:00:00.000Z",
    "version": "1.0"
  }
}

HTTP 202.

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