Restart an add-on
supervisor_restart_addonRestart a Home Assistant add-on to apply new options or recover from a stuck state. Briefly stops then starts the add-on, making it unavailable during the process.
Instructions
Restart an add-on (stop, then start).
Calls POST /addons/<slug>/restart. The add-on — which could be this
nexus add-on itself — is briefly unavailable during the restart.
Use when: an add-on needs to pick up new options or recover from a
stuck state.
Not for: a one-way stop — use supervisor_stop_addon; for restarting
Core instead — use supervisor_restart_core.
Returns: Supervisor's restart-job result.
Errors: {"error": "invalid_slug"} for a bad slug; {"error": "SUPERVISOR_TOKEN not set — Nexus must run as HA add-on for Supervisor API"} when the token env var is missing;
{"error": "HTTP <status>", "detail": ...} if the slug is unknown.
Limits: briefly interrupts the add-on's availability.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | Add-on slug to restart, e.g. from `supervisor_list_addons`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||