Skip to main content

Folder Actions

Actions allow real-time communication through HTTP requests. These device actions are easy to use and are particularly useful when implementing Action batches in your content.

  • They are typically triggered by an event, such as a command sent to a device.
  • When the event occurs, the device makes an HTTP request to the URL configured for the action.
  • To distinguish API calls, create individual API keys for each action.

Add Action - Folder

Name

Define the name of your folder action.

Event ID

An "event ID" is a unique identifier assigned to each action call. It helps track and manage different events sent by the actions to your system. This ID ensures individual handling of each event.
Note: This event ID must be unique.

Action Types

Force Sync

Forces the selected shared folders to sync.

Upload File

Uploads a file into a folder.

Target Type

Choose from All, Device, Device Group, or Device Tag as the target type.

Target

Select the target channel for the action.
Note: Multiple targets will be supported in future updates.

Teams

Assign teams to manage and view the data source.
Note: This option is available only if at least one team is configured for the customer.

How to Trigger an Action?

Create an API Key

Learn more: API Key

Click on the Generate Example Link button to open a modal.

API Key (Always Required)

An API key is necessary for webhook authentication and security.

File Content

Insert the Base64 text of the file.

Action Type Comparison

FieldUpload FileForce Sync
API Key✔️✔️
File Name✔️
File Content✔️
Overwrite Existing✔️
Valid From✔️
Valid To✔️

Final Steps

Generate a webhook call link for use within content as touch actions.

Test Action

Test the action on the selected target before deployment.