Manage a Prey device fleet: devices, locations, reports, actions, labels, geofences, automations and loans.
Explore 45 workflow actions for Prey, including account permissions and operation limits.
27 read actions18 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Add devices to a label
Write
Assigns one or more devices to an existing label by their device IDs.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a custom field
Write
Creates a new custom field for the account.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a geofence and assign devices
Write
This request allows you to create a new Geofence in your account, specifying the geofence's position, characteristics, action triggers for when devices move in or out of them, and notification.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a label to tag and group devices
Write
This allows you to create custom labels, or identifiers, that you can assign to devices you want to group by personalized characteristics.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new automation
Write
Creates a new automation that triggers an action on specified devices when certain conditions are met.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new loan for a device
Write
Assigns a device to a contact for a loan period.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a custom field
Write
Permanently deletes a custom field and all its device values.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a label
Write
Permanently deletes a label from the account.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a particular device from your fleet
Write
Delete a particular device from your fleet
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete an automation
Write
Permanently deletes an automation by its ID (soft delete - sets state to 'deleted').
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get current loan information for a device
Read
Returns the active or overdue loan details for a specific device.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
List all devices with active loans
Read
Returns a list of all devices currently loaned out.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Mark a specific device as missing or recovered
Write
This allows you to specify a device using its deviceID and change its missing status to 'true' or 'false'.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Modify the configurations and assigned devices of a specific geofence
Write
This request allows you to access a particular geofence and rewrite any of the fields in its configurations.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Rename a device
Write
Updates the display name of a specific device.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Request a location update from a device
Write
Sends a request to the device asking it to report its current location.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Retrieve a list of all automations in your account
Read
This request allows you to retrieve a list of all automations created under the account, with detailed information on its configurations, assigned devices, and schedule.<br/ <br/ <bHow to.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve a list of all devices in Prey account
Read
This request allows you to view a complete list of all devices linked to your account.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve a list of all geofences in your account
Read
This request allows you to retrieve a detailed list of all currently active geofences on the account.<br/ <br/ The information includes the geofence's ID, location, name, radius, color,.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve a list of all mass actions in your account
Read
This request allows you to retrieve a list of all mass actions created under your account, and the details of their configurations and target devices.<br/ <br/ <bHow to navigate pagination in.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve a list of currently active labels and devices assigned
Read
This request allows you to view all labels in your account, with a breakdown list of the devices that have been tagged with the label, and the label's ID.<br/ <br/ <bHow to navigate.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve a list of users in your Prey account
Read
This request will list all users currently active in your Prey's account.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve a particular device's information
Read
This request allows you to retrieve information on a specific device using the deviceID to identify it.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve a particular user's information
Read
This request allows you to select a specific user via the userId and view detailed information on the user's role and devices.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve a single report for a specific device
Read
This request allows you to retrieve a specific report with its respective information.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve a specific custom field
Read
Returns a single custom field by its ID, including the count of devices that have a value set for it.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve a specific label's information by ID
Read
This request allows you to view a specific label's details by specifying a label ID.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve all custom fields defined in the account
Read
Returns a paginated list of account-level custom fields.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve all of your Prey account's information
Read
This request will retrieve regarding your account configurations and characteristics.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve all the reports for a specific device
Read
This request allows you to retrieve a list of reports with their respective information.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve connection log events for all devices
Read
Returns a paginated list of device connection intervals showing when devices were online, their network details, and location data.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve custom field values for a device
Read
Returns all custom fields defined in the account along with their current value for the specified device.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve geofencing events for a specific device
Read
Returns a paginated list of geofencing entry and exit events for the specified device, ordered by most recent first.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve geofencing events for a specific geofence
Read
Returns a paginated list of geofencing entry and exit events for the specified geofence, ordered by most recent first.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve information for a particular automation
Read
This request allows you to retrieve information on a specific Automation using the automationId to identify it.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve information for a particular geofence
Read
This request allows you to retrieve information on a specific geofence using the geofence ID to identify it.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve information for a particular mass action
Read
This request allows you to retrieve information on a specific mass action using the massActionId to identify it.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve past locations of a specific device
Read
This request allows you to retrieve a list of a specific device's past locations, up to one month back in time.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve the event history of a device
Read
Returns a paginated list of events logged for the device, such as missing status changes, actions triggered, and location requests.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve the last known location of a device
Read
Returns the single most recent location recorded for the device.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Retrieve the latest entity of a given type from your account
Read
Returns the most recent record for the specified type.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
Terminate or return a loan
Write
Ends the current loan for a device.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Trigger an action on a particular device from your fleet
Write
This request allows you to trigger some of Prey's security actions in a specific device, identified by its deviceID.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a custom field
Write
Updates the label or type of an existing custom field.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing loan
Write
Modify the contact name, email, or loan dates for an active loan.
Permissions and limits
Account permissions
A Prey API key (Settings, Developer API; read or read and write)
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Prey. A saved workflow is not a completed provider action.