Skip to main content

Find Your Brain

The Aris Brain runs on your local network. Find it using:
If your network supports mDNS (most do):

Check Health

First, verify the Brain is running:
Response

Get an API Token

Most endpoints require authentication. Create an API token in the web UI:
  1. Open http://aris.local in your browser
  2. Go to SettingsAPI Tokens
  3. Click Create Token and give it a name (e.g., “My Script”)
  4. Copy the token—it’s only shown once
See Authentication for more details.

Read Zone Temperatures

Now use your token to read zone data:
Response

Set a Temperature

Adjust the heating setpoint for a zone:
Response
Setpoint constraints:
  • Valid range: 10-30°C (50-86°F)
  • Minimum 2.2°C (4°F) gap between heat and cool setpoints

Change System Mode

Switch the entire system between heating and cooling:
Available modes:
  • heat - Heating only
  • cool - Cooling only
  • auto - Automatic switchover
  • off - System off

Next Steps

Authentication

Learn about API tokens

Controlling Zones

Deep dive into zone control

Monitoring

Set up monitoring and alerts

API Reference

Explore all endpoints