How-tobeginneradmin, member
How to Restart an Agent
Three ways to restart an agent: dashboard, API and CLI.
2 min read6,810 viewsUpdated 2026-02-12
NovaGuide Assistant
In this article you'll learn about Via Dashboard, then explore Via API, and finally review Via CLI.
Via Dashboard
Open the agent detail page and click the ⟳ Restart button in the top-right corner. The agent will gracefully finish its current task before restarting.
A graceful restart waits up to 30 seconds for the current task to complete. If it doesn't finish in time, the task is re-queued.
Via API
Send a POST request to the restart endpoint:
curl -X POST \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
https://api.botonom.com/v1/agents/<agent-id>/restart
Returns a 202 Accepted response:
{
"status": "restarting",
"estimated_time_seconds": 15
}
Via CLI
If you have the Botonom CLI installed:
# Graceful restart
botonom agent restart <agent-id>
# Force restart (skips graceful shutdown)
botonom agent restart <agent-id> --force
Using
--force will immediately terminate the current task. Use with caution.restartmanagement
Was this helpful?
More questions? Contact support