API Reference

The Sanytron REST API provides programmatic access to your devices, scenes, and automations. Base URL: https://hub.sanytron.com/api/v1

🚧 The Sanytron public API is currently in active development. The endpoints below represent the planned interface. Join the developer community for early access and updates.

Authentication

All API requests will require a valid API key, included in the Authorization header:

Authorization: Bearer YOUR_API_KEY

API keys will be manageable from your Sanytron Hub account dashboard.

Planned Endpoints

GET /devices

List all connected devices and their current states.

curl https://hub.sanytron.com/api/v1/devices \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /devices/{id}

Get detailed information about a specific device.

curl https://hub.sanytron.com/api/v1/devices/living_room_light \
  -H "Authorization: Bearer YOUR_API_KEY"

POST /scenes/{id}/trigger

Activate a predefined scene across all connected devices.

curl -X POST https://hub.sanytron.com/api/v1/scenes/movie_night/trigger \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /automations

List all configured automations and their status.

curl https://hub.sanytron.com/api/v1/automations \
  -H "Authorization: Bearer YOUR_API_KEY"

Questions about the API? Explore code examples or join the developer community.