owner: gmikcon status: active last_reviewed: 2026-05-10 review_interval: 90d confidence: medium
... (existing content) ...
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.
POST /api/v1/scripts/actions/runRequest 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.