Itsyhome Control

Itsyhome exposes a local HTTP webhook server (default port 8423) and a URL scheme (itsyhome://).

Prerequisites: Itsyhome Pro, webhook server enabled in Settings → Webhooks.

Core Pattern

All control and query happens via curl http://localhost:8423/\x3Caction>/\x3Ctarget>.

• Targets use Room/Device format or just DeviceName
• Spaces → %20 in URLs
• On success: {"success": true} or JSON data
• On failure: {"error": "..."} with HTTP 4xx

Workflow

1. If target is ambiguous → curl http://localhost:8423/list/devices to find exact names
2. To check current state → curl http://localhost:8423/info/\x3Ctarget>
3. To control → appropriate action endpoint (see references/api.md)
4. Confirm to user with what was done; include state if queried

Quick Reference

# Status
curl http://localhost:8423/status

# List
curl http://localhost:8423/list/rooms
curl http://localhost:8423/list/devices
curl http://localhost:8423/list/devices/Kitchen

# Query
curl http://localhost:8423/info/Office/Spotlights

# Control
curl http://localhost:8423/toggle/Office/Spotlights
curl http://localhost:8423/on/Kitchen/Light
curl http://localhost:8423/brightness/50/Bedroom/Lamp
curl http://localhost:8423/scene/Goodnight

For the full endpoint list, all control actions, and URL scheme reference: see references/api.md.