Overkiz (Tahoma) icon

Overkiz (Tahoma)

Interact with Overkiz (Tahoma) API

Actions3

Overview

The Overkiz (Tahoma) - Object: Execute Command node allows you to execute a specific command on a selected Overkiz (Tahoma) object (device). This is useful for automating actions such as turning devices on/off, setting device parameters (like color), or triggering custom behaviors supported by your Overkiz-compatible smart home devices.

Common scenarios:

  • Remotely controlling smart home devices (e.g., lights, shutters, thermostats).
  • Integrating Overkiz device actions into broader automation workflows.
  • Setting device-specific parameters, such as changing the color of a smart light.

Practical example:
You could use this node in an n8n workflow to change the color of a smart bulb when a certain event occurs (e.g., receiving a webhook or at a scheduled time).

Properties

Name Meaning
Object Name or ID The target Overkiz object (device) to perform the command on. You can select from a list of available devices or specify an ID using an expression.
Command Name or ID The command to execute on the selected object. Options are dynamically loaded based on the chosen object and may include commands like "Turn On", "Set Color", etc. Can be selected from a list or specified by ID/expression.
Color (Only shown if the selected command is genericSetRGBColor) The color value to set, in hexadecimal format (e.g., #ff0000 for red).

Output

The output is a JSON object representing the updated state of the targeted Overkiz object after the command execution. The structure includes all properties of the device as returned by the Overkiz API, such as:

{
  "json": {
    // All properties of the device, e.g.:
    "URL": "/io:Light/123456",
    "name": "Living Room Light",
    "definition": {
      "uiClass": "Light",
      // ...other definition fields
    },
    "widget": "Light",
    // ...other device-specific fields
  }
}
  • If the command cannot be executed or the object is not found, the output will be an empty array.

Dependencies

  • External Service: Requires access to the Overkiz (Tahoma) API.
  • Credentials: You must configure valid overkizApi credentials in n8n for this node to function.
  • n8n Configuration: No additional environment variables required beyond standard credential setup.

Troubleshooting

Common issues:

  • Missing Credentials:
    Error message: No credentials!
    Resolution: Ensure that the overkizApi credentials are properly configured in n8n.

  • Invalid Object or Command:
    If the selected object or command does not exist or is unsupported, the node will return an empty result.
    Resolution: Double-check that the object and command are valid and available for your Overkiz setup.

  • Command Execution Fails:
    If the command cannot be executed (e.g., due to device offline or unsupported operation), the output will be empty.
    Resolution: Verify device connectivity and that the command is appropriate for the selected device.

Links and References

Discussion