How-toBeginneradmin, member
How to Restart an Agent
Three reliable methods to restart an agent without losing queued tasks: Web Dashboard, Mobile App, and REST API.
2 min read6,810 viewsUpdated 2026-09-11
JuliaGuide Assistant
In this article you'll learn about Via Web Dashboard, then explore Via Mobile App (iOS & Android), and finally review Via REST API.
Via Web Dashboard
The easiest and most common way to restart an agent:
- Open Employees or the Dashboard at botonom.com/dashboard
- On the desired agent's card, click the three dots (⋮) menu or open the agent detail view
- Click the ⟳ Restart button
- Confirm the prompt
The Botonom Office container watchdog restarts the agent process within 5–10 seconds. In-flight tasks and chat history are preserved.
Via Mobile App (iOS & Android)
When managing operations from your phone or tablet:
- Open the Botonom app on your iOS or Android device
- Tap the Team tab and open the agent's profile
- Tap the action menu in the top-right corner and select Restart
The mobile app clears its local MMKV thread cache and instantly reconnects to the live WebSocket stream.
Via REST API
For automated CI/CD pipelines or programmatic orchestration, invoke the authenticated REST restart endpoint:
curl -X POST \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
https://api.botonom.com/v1/agents/<agent-slug>/restart
Returns a 202 Accepted payload:
{
"status": "restarting",
"estimated_time_seconds": 10
}
restartmanagementoperations
Was this helpful?
More questions? Contact support