NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

System → Get Locations

AI-generated

Overview

This node integrates with the NinjaOne API to retrieve system-related data. Specifically, the "Get Locations" operation under the "System" resource fetches a list of locations managed within NinjaOne. This is useful for workflows that need to organize or filter assets, devices, or policies by their physical or logical location.

Practical examples include:

  • Automating asset management by syncing location data into an external database.
  • Filtering alerts or tickets based on device locations.
  • Generating reports segmented by location.

Properties

Name Meaning
Page Size Limit number of locations to return. If set to 0, it may return all available locations.
After Last Location Identifier from previous page, used for pagination to get the next set.

Output

The node outputs an array of JSON objects, each representing a location retrieved from the NinjaOne API. The exact structure depends on the API response but typically includes fields such as location ID, name, and other metadata.

No binary data output is involved in this operation.

Dependencies

  • Requires an API authentication token configured via OAuth2 credentials for NinjaOne.
  • The node uses NinjaOne's REST API endpoints to fetch data.
  • No additional environment variables are explicitly required beyond the API credential setup.

Troubleshooting

  • Common issues:

    • Pagination parameters (Page Size and After) not set correctly may result in incomplete data retrieval.
    • Missing or invalid API credentials will cause authentication failures.
    • Network connectivity issues can prevent successful API calls.
  • Error messages:

    • Errors related to missing binary data do not apply here since this operation does not handle binary inputs.
    • Authentication errors will indicate invalid or expired tokens; re-authenticate the NinjaOne API credential.
    • API rate limits or server errors will be returned from the NinjaOne API and surfaced as error messages.

Links and References

Discussion