Newer
Older
gnexus-book / 10-systems / servers / smart-home-server.md

owner: gmikcon status: active last_reviewed: 2026-05-10 review_interval: 90d confidence: medium

source_of_truth: owner-confirmed-and-ssh-host

Smart Home Server

... (existing content) ...

API Usage: Triggering Actions

The smart-home platform allows triggering ControlScripts actions via HTTP POST. This is the preferred way for external automation or manual control without the web client.

Endpoint: POST /api/v1/scripts/actions/run

Request Body (JSON):

{
  "alias": "action_alias_here",
  "params": {}
}

Example: Toggle Bedroom Light

curl -X POST http://192.168.1.101/api/v1/scripts/actions/run \
     -H "Content-Type: application/json" \
     -d '{"alias": "master_room_lamp_switcher", "params": {}}'

Example: Toggle Hallway Light (2nd Floor)

curl -X POST http://192.168.1.101/api/v1/scripts/actions/run \
     -H "Content-Type: application/json" \
     -d '{"alias": "hallway2_lamp_switcher", "params": {}}'

Response Format: Returns a JSON object with status: true and the return value from the PHP script.