developers.home-assistant/docs/api/supervisor/models.md

title
Models

These models are describing objects that are getting returned from the supervisor API.

Addon

key	type	description
name	string	The name of the add-on
slug	string	The slug for the add-on
advanced	boolean	true if it should only be visible to advanced users
description	string	The description of the add-on
repository	string	The repository the add-on came from
version	string or null	The installed version of the add-on
version_latest	string	The latest published version of the add-on
update_available	boolean	true if an update is available
installed	string	true if the the add-on is installed
available	boolean	false if you can not install the add-on
icon	bool	The add-on has an icon file
logo	bool	The add-on has a logo file
state	string	The state of the add-on (started, stopped)

Application

key	type	description
name	string	The application name
index	int	TODO: What is this?
stream_index	int	TODO: What is this?
stream_type	string	The type of the stream (INPUT, OUTPUT)
volume	float	The current volume
mute	boolean	true if the application is muted
addon	string	The add-on slug

Audio

key	type	description
card	list	A list of Card models
input	list	A list of Audio device models
output	list	A list of Output device models
application	list	A list of Application models

Audio device

key	type	description
name	string	The name of the device
index	int	TODO: What is this?
description	string	The description of the device
volume	float	The current volume
mute	string	true if the device is muted
default	string	true if the device is default
card	int or null	TODO: What is this?
applications	string	A list of Application models

Audio profile

key	type	description
name	string	The name of the profile
description	string	The description of the profile
active	boolean	true if the profile is active

Card

key	type	description
name	string	The name of the card
index	int	TODO: What is this?
driver	string	The name of the card driver
profiles	list	A list of Audio profile models

Discovery

key	type	description
addon	string	The add-on slug
service	string	The service name
uuid	string	The UUID of the discovery
config	dict	The configuration

Host service

key	type	description
name	string	The service name
description	string	The service description
state	string	The service state

Network interface

key	type	description
interface	string	The interface name i.e eth0.
type	string	The interface type: ethernet, wireless or vlan.
enabled	boolean	Return True if the interface is enabled.
connected	boolean	Return True if the interface is connected to the network.
primary	boolean	true if it's the primary network interface.
ipv4	struct or null	An IP config struct with IPv4 connection details.
ipv6	struct or null	An IP config struct with IPv6 connection details.
wifi	struct or null	A Wifi config struct with wireless connection details.
vlan	struct or null	A Vlan config struct with details about the vlan.

IP configuration

key	type	description
method	string	The method used to set the IP can be static, auto or disabled.
address	list	A list with IP address and the netmask in a X.X.X.X/XX format.
gateway	string	The IP address of the gateway.
nameservers	list	A list containing the IP addresses of the configured nameservers as strings.

Wifi configuration

key	type	description
mode	string	Set the mode infrastructure, mesh, adhoc or ap.
auth	string	Set the auth mode: open, web or wpa-psk.
ssid	string	Set the SSID for the Wireless.
signal	integer	Percentage of signal strength.

VLAN configuration

key	type	description
id	integer	The VLAN ID.
parent	string	Parent interface which is the vlan attached.

Access-points

key	type	description
mode	string	One of: infrastructure, mesh or adhoc.
ssid	string	Wireless network ID.
frequency	integer	The operating frequency of this Access Point.
signal	integer	Percentage of signal strength.
mac	string	MAC Address of the Access Point.

Panel

key	type	description
enable	boolean	true if it's enabled
icon	string	The sidebar icon
title	string	The sidebar title
admin	boolean	true if it's for admin accounts only

Repository

key	type	description
slug	string	The repository slug
name	string	The name of the repository
source	string	The URL to the repository
url	string or null	URL for repository website
maintainer	string	The name of the repository maintainer

Service

key	type	description
slug	string	The service slug
available	boolean	true if the service is available
providers	list	A list of providers for the service

Backup

key	type	description
slug	string	A generated slug for the backup
date	string	ISO date string representation of the date the backup was created
name	string	The name given to the backup
type	string	The type of backup (full, partial)
protected	boolean	true if the backup is password protected
content	dictionary	A dictionary describing the content of the backup
compressed	boolean	true if the backup is saved in a compressed archive

Backup -> content

The content key of a backup object contains the following keys:

key	type	description
homeassistant	boolean	true if the backup contains homeassistant
addons	list	A list of add-on slugs included in the backup
folders	list	A list of folder names included in the backup

Backup details

key	type	description
slug	string	A generated slug for the backup
type	string	The type of backup (full, partial)
name	string	The name given to the backup
date	string	ISO date string representation of the date the backup was created
size	string	The size of the backup in MB
protected	boolean	true if the backup is password protected
location	string or null	The name of the backup mount it's stored on. null if it's stored locally.
homeassistant	string	The version of Home Assistant that was in use
addons	list	A list of add-ons in the backup. Add-ons are represented as a dictionary with these keys [slug,name,version,size]
repositories	list	A list of add-on repository URL's as strings
folders	list	A list of strings representing directories
homeassistant_exclude_database	boolean	true if the Home Assistant database file was excluded from this backup

Stats

key	type	description
cpu_percent	float	The percentage of the CPU that is used
memory_usage	int	The current memory usage in bytes
memory_limit	int	The max allowed memory usage in bytes
memory_percent	float	The percentage of the memory that is used
network_tx	int	Network transmission usage
network_rx	int	Network receiver usage
blk_read	int	File system read usage
blk_write	int	File system write usage

Issue

key	type	description
uuid	str	A generated uuid as issue ID
type	str	Type of the issue
context	str	In which context the issue occurs
reference	str or null	Depend on the Context, a reference to another Model

Suggestion

key	type	description
uuid	str	A generated uuid as suggestion ID
type	str	Type of the suggestion
context	str	In which context the suggestion occurs
reference	str or null	Depend on the Context, a reference to another Model
auto	bool	True if the suggested fix will be auto-applied

Check

key	type	description
slug	str	A generated slug for the check
enable	bool	The enabled state of the check

Device

key	type	description
name	string	Name of the device object
sysfs	string	Path to sysfs device object
dev_path	string	Path to devfs
subsystem	string or null	Subsystem type of the device (tty, input, sound, block, misc)
parent	string or null	Path to the parent sysfs device object
by_id	string or null	Udev by ID link
attributes	dict	A dict with pure udev device attributes for debug and understanding
children	list	A list of path to the children sysfs devices

Disk

key	type	description
name	string	Name of the disk device
vendor	string	Vendor of the disk device
model	string	Model of the disk device
serial	string	Serial number of the disk device
size	int	Size of disk in bytes
id	string	Unique ID for the disk device (either UDisks2 drive ID or device path)
dev_path	string	Device path for the disk device

Mount

key	type	description	request/response
name	string	Name of the mount	both
type	string	Type of the mount (cifs or nfs)	both
usage	string	Usage of the mount (backup, media, or share)	both
server	string	IP address or hostname of the network share server	both
port	int	Port to use (if not using the standard one for the mount type)	both
read_only	bool	Mount is read-only (not available for backup mounts)	both
path	string	(nfs mounts only) Path to mount from the network share	both
share	string	(cifs mounts only) Share to mount from the network share	both
username	string	(cifs mounts only) Username to use for authentication	request only
password	string	(cifs mounts only) Password to use for authentication	request only
state	string	Current state of the mount (active, failed, etc.)	response only

Request only fields may be included in requests but will never be in responses. Response only fields will be in responses but cannot be included in requests.

Job

key	type	description
name	string	Name of the job
reference	string	A unique ID for instance the job is acting on (if applicable)
uuid	string	Unique ID of the job
progress	int	Progress of the job (if accurate progress is obtainable)
stage	string	A name for the stage the job is in (if applicable)
done	boolean	Is the job complete
child_jobs	list	A list of child jobs started by this one
errors	list	A list of errors that occurred during execution

Job error

key	type	description
type	string	Type of error that occurred
message	string	Human-readable description of what went wrong

Boot slot

key	type	description
state	string	Active or inactive (active slot is in use)
status	string	Status of the last boot from slot (good or bad)
version	string	Version of OS installed

User

key	type	description
username	string	Username used to login
name	string	Name of the user
is_owner	boolean	Is the user the owner
is_active	boolean	Is the user active
local_only	boolean	Can the user login from the network (e.g. via http)
group_ids	list	Role(s) the user has (admin, etc)

Drive

key	type	description
vendor	string	Drive vendor
model	string	Drive model
serial	string	Drive serial number
id	string	Unique and persistent id for drive
size	int	Size of the drive in bytes
time_detected	datetime	Time drive was detected by system
connection_bus	string	Physical connection bus of the drive (USB, etc.)
seat	string	Identifier of seat drive is plugged into
removable	boolean	Is the drive removable by the user?
ejectable	boolean	Is the drive ejectable by the system?
filesystems	list	A list of filesystem partitions on the drive

Filesystem

key	type	description
device	string	Special device file for the filesystem (e.g. /dev/sda1)
id	string	Unique and persistent id for filesystem
size	int	Size of the filesystem in bytes
name	string	Name of the filesystem (if known)
system	boolean	true if filesystem considered a system/internal device
mount_points	list	List of paths where the filesystem is mounted.