Interface for Home Assistant to control things from supervisor.
On error / Code 400:
{
"result": "error",
"message": ""
}On success / Code 200:
{
"result": "ok",
"data": { }
}For access to API you need set the X-HASSIO-KEY they will be available for Add-ons/HomeAssistant with envoriment HASSIO_TOKEN.
- GET
/supervisor/ping - GET
/supervisor/info
The addons from addons are only installed one.
{
"version": "INSTALL_VERSION",
"last_version": "LAST_VERSION",
"arch": "armhf|aarch64|i386|amd64",
"channel": "stable|beta|dev",
"timezone": "TIMEZONE",
"wait_boot": "int",
"addons": [
{
"name": "xy bla",
"slug": "xy",
"description": "description",
"repository": "12345678|null",
"version": "LAST_VERSION",
"installed": "INSTALL_VERSION",
"icon": "bool",
"logo": "bool",
"state": "started|stopped",
}
],
"addons_repositories": [
"REPO_URL"
]
}- POST
/supervisor/update
Optional:
{
"version": "VERSION"
}- POST
/supervisor/options
{
"channel": "stable|beta|dev",
"timezone": "TIMEZONE",
"wait_boot": "int",
"addons_repositories": [
"REPO_URL"
]
}- POST
/supervisor/reload
Reload addons/version.
- GET
/supervisor/logs
Output is the raw docker log.
- GET
/supervisor/stats
{
"cpu_percent": 0.0,
"memory_usage": 283123,
"memory_limit": 329392,
"network_tx": 0,
"network_rx": 0,
"blk_read": 0,
"blk_write": 0
}- GET
/snapshots
{
"snapshots": [
{
"slug": "SLUG",
"date": "ISO",
"name": "Custom name",
"type": "full|partial",
"protected": "bool"
}
]
}-
POST
/snapshots/reload -
POST
/snapshots/new/upload
return:
{
"slug": ""
}- POST
/snapshots/new/full
{
"name": "Optional",
"password": "Optional"
}return:
{
"slug": ""
}- POST
/snapshots/new/partial
{
"name": "Optional",
"addons": ["ADDON_SLUG"],
"folders": ["FOLDER_NAME"],
"password": "Optional"
}return:
{
"slug": ""
}-
POST
/snapshots/reload -
GET
/snapshots/{slug}/info
{
"slug": "SNAPSHOT ID",
"type": "full|partial",
"name": "custom snapshot name / description",
"date": "ISO",
"size": "SIZE_IN_MB",
"protected": "bool",
"homeassistant": "version",
"addons": [
{
"slug": "ADDON_SLUG",
"name": "NAME",
"version": "INSTALLED_VERSION",
"size": "SIZE_IN_MB"
}
],
"repositories": ["URL"],
"folders": ["NAME"]
}-
POST
/snapshots/{slug}/remove -
GET
/snapshots/{slug}/download -
POST
/snapshots/{slug}/restore/full
{
"password": "Optional"
}- POST
/snapshots/{slug}/restore/partial
{
"homeassistant": "bool",
"addons": ["ADDON_SLUG"],
"folders": ["FOLDER_NAME"],
"password": "Optional"
}-
POST
/host/reload -
POST
/host/shutdown -
POST
/host/reboot -
GET
/host/info
{
"hostname": "hostname|null",
"features": ["shutdown", "reboot", "update", "hostname"],
"operating_system": "Hass.io-OS XY|Ubuntu 16.4|null",
"kernel": "4.15.7|null",
"chassis": "specific|null",
"type": "Hass.io-OS Type|null",
"deployment": "stable|beta|dev|null",
"version": "xy|null",
"last_version": "xy|null",
}- POST
/host/options
{
"hostname": "",
}- POST
/host/update
Optional:
{
"version": "VERSION"
}- POST
/host/reload
- GET
/hardware/info
{
"serial": ["/dev/xy"],
"input": ["Input device name"],
"disk": ["/dev/sdax"],
"gpio": ["gpiochip0", "gpiochip100"],
"audio": {
"CARD_ID": {
"name": "xy",
"type": "microphone",
"devices": {
"DEV_ID": "type of device"
}
}
}
}- GET
/hardware/audio
{
"audio": {
"input": {
"0,0": "Mic"
},
"output": {
"1,0": "Jack",
"1,1": "HDMI"
}
}
}- GET
/homeassistant/info
{
"version": "INSTALL_VERSION",
"last_version": "LAST_VERSION",
"machine": "Image machine type",
"image": "str",
"custom": "bool -> if custom image",
"boot": "bool",
"port": 8123,
"ssl": "bool",
"watchdog": "bool",
"startup_time": 600
}- POST
/homeassistant/update
Optional:
{
"version": "VERSION"
}- GET
/homeassistant/logs
Output is the raw Docker log.
-
POST
/homeassistant/restart -
POST
/homeassistant/check -
POST
/homeassistant/start -
POST
/homeassistant/stop -
POST
/homeassistant/options
{
"image": "Optional|null",
"last_version": "Optional for custom image|null",
"port": "port for access hass",
"ssl": "bool",
"password": "",
"watchdog": "bool",
"startup_time": 600
}Image with null and last_version with null reset this options.
- POST/GET
/homeassistant/api
Proxy to real home-assistant instance.
- GET
/homeassistant/websocket
Proxy to real websocket instance.
- GET
/homeassistant/stats
{
"cpu_percent": 0.0,
"memory_usage": 283123,
"memory_limit": 329392,
"network_tx": 0,
"network_rx": 0,
"blk_read": 0,
"blk_write": 0
}- GET
/addons
Get all available addons.
{
"addons": [
{
"name": "xy bla",
"slug": "xy",
"description": "description",
"arch": ["armhf", "aarch64", "i386", "amd64"],
"repository": "core|local|REP_ID",
"version": "LAST_VERSION",
"installed": "none|INSTALL_VERSION",
"detached": "bool",
"build": "bool",
"url": "null|url",
"icon": "bool",
"logo": "bool"
}
],
"repositories": [
{
"slug": "12345678",
"name": "Repitory Name|unknown",
"source": "URL_OF_REPOSITORY",
"url": "WEBSITE|REPOSITORY",
"maintainer": "BLA BLU <[email protected]>|unknown"
}
]
}- POST
/addons/reload - GET
/addons/{addon}/info
{
"name": "xy bla",
"slug": "xdssd_xybla",
"description": "description",
"long_description": "null|markdown",
"auto_update": "bool",
"url": "null|url of addon",
"detached": "bool",
"repository": "12345678|null",
"version": "null|VERSION_INSTALLED",
"last_version": "LAST_VERSION",
"state": "none|started|stopped",
"boot": "auto|manual",
"build": "bool",
"options": "{}",
"network": "{}|null",
"host_network": "bool",
"host_ipc": "bool",
"host_dbus": "bool",
"privileged": ["NET_ADMIN", "SYS_ADMIN"],
"seccomp": "disable|default|profile",
"apparmor": "disable|default|profile",
"devices": ["/dev/xy"],
"auto_uart": "bool",
"icon": "bool",
"logo": "bool",
"changelog": "bool",
"hassio_api": "bool",
"homeassistant_api": "bool",
"stdin": "bool",
"webui": "null|http(s)://[HOST]:port/xy/zx",
"gpio": "bool",
"audio": "bool",
"audio_input": "null|0,0",
"audio_output": "null|0,0",
"services": "null|['mqtt']",
"discovery": "null|['component/platform']"
}-
GET
/addons/{addon}/icon -
GET
/addons/{addon}/logo -
GET
/addons/{addon}/changelog -
POST
/addons/{addon}/options
{
"boot": "auto|manual",
"auto_update": "bool",
"network": {
"CONTAINER": "port|[ip, port]"
},
"options": {},
"audio_output": "null|0,0",
"audio_input": "null|0,0"
}Reset custom network/audio/options, set it null.
-
POST
/addons/{addon}/start -
POST
/addons/{addon}/stop -
POST
/addons/{addon}/install -
POST
/addons/{addon}/uninstall -
POST
/addons/{addon}/update -
GET
/addons/{addon}/logs
Output is the raw Docker log.
-
POST
/addons/{addon}/restart -
POST
/addons/{addon}/rebuild
Only supported for local build addons
- POST
/addons/{addon}/stdin
Write data to add-on stdin
- GET
/addons/{addon}/stats
{
"cpu_percent": 0.0,
"memory_usage": 283123,
"memory_limit": 329392,
"network_tx": 0,
"network_rx": 0,
"blk_read": 0,
"blk_write": 0
}- GET
/services/discovery
{
"discovery": [
{
"provider": "name",
"uuid": "uuid",
"component": "component",
"platform": "null|platform",
"config": {}
}
]
}- GET
/services/discovery/{UUID}
{
"provider": "name",
"uuid": "uuid",
"component": "component",
"platform": "null|platform",
"config": {}
}- POST
/services/discovery
{
"component": "component",
"platform": "null|platform",
"config": {}
}return:
{
"uuid": "uuid"
}-
DEL
/services/discovery/{UUID} -
GET
/services
{
"services": [
{
"slug": "name",
"available": "bool",
"provider": "null|name|list"
}
]
}- GET
/services/xy
{
"available": "bool",
"xy": {}
}This service perform a auto discovery to Home-Assistant.
- GET
/services/mqtt
{
"provider": "name",
"host": "xy",
"port": "8883",
"ssl": "bool",
"username": "optional",
"password": "optional",
"protocol": "3.1.1"
}- POST
/services/mqtt
{
"host": "xy",
"port": "8883",
"ssl": "bool|optional",
"username": "optional",
"password": "optional",
"protocol": "3.1.1"
}- DEL
/services/mqtt