Actions7
Device → List
AI-generatedOverview
This node interacts with the Level API to list devices. It allows users to retrieve a list of devices with optional detailed information such as CPUs, disks, memory, network interfaces, and operating system. It supports filtering by group ID or ancestor group ID, pagination through cursors, and additional query parameters. This node is useful for scenarios where users need to inventory or monitor devices in an environment, such as IT asset management or network monitoring.
Use Case Examples
- List all devices in an organization with detailed CPU and memory information included.
- Retrieve devices belonging to a specific group or without a parent group.
- Paginate through devices using starting_after and ending_before cursors to handle large datasets.
Properties
| Name | Meaning |
|---|---|
| Include CPUs | Whether to include detailed CPU information in the response |
| Include Disks | Whether to include detailed disk and disk partition information in the response |
| Include Memory | Whether to include detailed memory information in the response |
| Include Network Interfaces | Whether to include detailed network interface information in the response |
| Include Operating System | Whether to include detailed operating system information in the response |
| Additional Query Parameters | Additional query string parameters supported by the API, allowing customization of the request. |
| Return All | Whether to return all results or only up to a given limit |
| Limit | Maximum number of results to return when not returning all |
| Group ID | Filter to only include devices with the given parent group ID. If not provided, all devices are returned. If 'null' is provided, only devices without a parent group are returned. |
| Ancestor Group ID | Filter to only include devices with the given group ID as an ancestor |
| Starting After | A cursor for pagination to fetch the next page of results after the specified ID |
| Ending Before | A cursor for pagination to fetch the previous page of results before the specified ID |
| Response Property Name | If the API response wraps the array in a property (e.g. 'devices'), set that property name. If left empty, the node attempts to auto-detect and returns the raw response if needed. |
| Request Options | Settings for batching, SSL validation, proxy, and timeout to customize the HTTP request behavior. |
Output
JSON
devices- Array of device objects returned by the API, each containing device details and optionally detailed CPU, disk, memory, network interface, and operating system information depending on input properties.
Dependencies
- Level API
- API key credential for authentication
Troubleshooting
- Ensure the API base URL and credentials are correctly configured to avoid authentication errors.
- If pagination cursors (starting_after, ending_before) are used incorrectly, the node may return empty or unexpected results; verify cursor values.
- Including detailed information (CPUs, disks, memory, etc.) may increase response size and latency; adjust properties accordingly if performance issues occur.
- If SSL certificate validation fails and 'Ignore SSL Issues' is not enabled, requests may be blocked; enable this option only if you trust the network environment.
Links
- Level API Documentation - Official API documentation for the Level platform, detailing endpoints and parameters for device listing and other resources.