NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Devices → Get Device Services

AI-generated

Overview

This node interacts with the NinjaOne API to retrieve information about device services. Specifically, the "Get Device Services" operation fetches a list of services running on a specified device, optionally filtered by service name and state. This is useful for IT administrators or automation workflows that need to monitor, audit, or manage services on devices remotely.

Practical examples include:

  • Automatically checking if critical services are running on a device.
  • Filtering services by their current state (e.g., only running services).
  • Integrating service status checks into broader incident response or maintenance workflows.

Properties

Name Meaning
Id The unique identifier of the device whose services you want to retrieve.
Name (Optional) Filter services by their exact service name.
State (Optional) Filter services by their state. Possible values: UNKNOWN, STOPPED, START PENDING, RUNNING, STOP PENDING, PAUSE PENDING, PAUSED, CONTINUE PENDING

Output

The node outputs an array of JSON objects representing the device services matching the query parameters. Each object corresponds to a service and contains details as returned by the NinjaOne API. The exact structure depends on the API response but typically includes service identifiers, names, states, and other metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the NinjaOne API using OAuth2 authentication.
  • The node expects the user to configure the NinjaOne API credentials in n8n before use.
  • Network access to the NinjaOne API endpoint is necessary.

Troubleshooting

  • Missing or invalid device Id: The "Id" property is required. Ensure it is set correctly; otherwise, the API call will fail.
  • No services returned: If filtering by name or state yields no results, verify that the filters match existing services on the device.
  • Authentication errors: Ensure the NinjaOne API credentials are valid and have sufficient permissions.
  • Binary data errors: Not applicable for this operation.
  • API request failures: Check network connectivity and NinjaOne API status.

Links and References

Discussion