itsyhome-control

# 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/<action>/<target>`. - 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/<target>` 3. **To control** → appropriate action endpoint (see references/api.md) 4. **Confirm to user** with what was done; include state if queried ## Quick Reference ```bash # 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](references/api.md).