Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Device → Get One Device

AI-generated

Overview

This node integrates with the Halo PSA API to retrieve detailed information about a single device by its identifier. It is designed to fetch comprehensive device data, optionally including related details such as activity logs, allowed statuses, hierarchy, diagrams, and extra metadata.

Common scenarios where this node is beneficial include:

  • Fetching device details for asset management or inventory tracking.
  • Retrieving extended device information for reporting or auditing purposes.
  • Integrating device data into workflows that require enriched context about hardware assets.

For example, you might use this node to get a device's full profile including its activity history and status options before triggering maintenance tasks or notifications.

Properties

Name Meaning
Id The unique numeric identifier of the device to retrieve (required).
Assettype Id Optional filter to specify the asset type ID associated with the device.
Includeactivity Boolean flag to include activity details related to the device in the response.
Includeallowedstatus Boolean flag to include allowed status details for the device in the response.
Includedetails Boolean flag to include extra objects/details in the response.
Includediagramdetails Boolean flag to include diagram-related details in the response.
Includehierarchy Boolean flag to include hierarchy information related to the device in the response.

Output

The node outputs a JSON object representing the device data retrieved from the Halo PSA API. This includes the device's core attributes and any additional details requested via the boolean flags.

The output structure varies depending on which optional properties are enabled but generally contains:

  • Device identification and metadata.
  • Activity logs if Includeactivity is true.
  • Allowed statuses if Includeallowedstatus is true.
  • Additional nested objects if Includedetails is true.
  • Diagram details if Includediagramdetails is true.
  • Hierarchy information if Includehierarchy is true.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Halo PSA API.
  • Needs valid API credentials including base URL, tenant identifier, client ID, and client secret configured in n8n.
  • The node uses HTTP requests with appropriate headers for authentication.
  • No other external dependencies beyond the Halo PSA API and n8n environment.

Troubleshooting

  • Missing Credentials: If no credentials are provided or invalid, the node will throw an error "No credentials returned!". Ensure API credentials are correctly set up in n8n.
  • Resource or Operation Not Found: Errors like "Resource Device not found" or "Operation Get One Device not found for resource Device" indicate misconfiguration of parameters.
  • Invalid Device Id: Providing an incorrect or non-existent device ID may result in API errors or empty responses.
  • API Request Failures: Network issues or incorrect API endpoint URLs can cause request failures. Verify connectivity and credential correctness.
  • JSON Parsing Errors: If additional query or body parameters are provided as JSON strings, ensure they are well-formed to avoid parsing exceptions.

To resolve these issues, verify all input parameters, credentials, and network access to the Halo PSA API.

Links and References

Discussion