Level icon

Level

Interact with the Level API

Actions7

Group → List

AI-generated

Overview

This node interacts with the Level API to list groups. It supports filtering groups by parent group ID, pagination through 'starting_after' and 'ending_before' cursors, and additional query parameters. It is useful for retrieving hierarchical group data, such as organizational units or device groups, with control over the number of results and pagination.

Use Case Examples

  1. Retrieve all root groups by setting 'Parent Group ID' to 'null'.
  2. List up to 50 groups with a specific parent group ID.
  3. Paginate through groups using 'Starting After' and 'Ending Before' cursors.

Properties

Name Meaning
Return All Whether to return all results or only up to a given limit.
Limit Maximum number of results to return when 'Return All' is false.
Parent Group ID Filter to only include groups with the given parent ID. Use 'null' to return only root groups.
Starting After Cursor for pagination to fetch the next page of results after the specified ID.
Ending Before Cursor for pagination to fetch the previous page of results before the specified ID.
Additional Query Parameters Additional query string parameters supported by the API to customize the request.
Response Property Name If the API response wraps the array in a property, specify that property name to extract the array. If empty, the whole response is returned.
Request Options Settings for batching, SSL validation, proxy, and timeout to control the request behavior.

Output

JSON

  • groups - Array of group objects returned from the API, or the entire response if no response property name is specified.

Dependencies

  • Level API

Troubleshooting

  • Ensure the API credentials are correctly configured to avoid authentication errors.
  • If pagination cursors ('Starting After' or 'Ending Before') are incorrect or outdated, the node may return empty results or errors.
  • Setting 'Return All' to true with a very large dataset may cause performance issues or timeouts; consider using pagination instead.
  • If the API response structure changes, update the 'Response Property Name' accordingly to correctly extract the group list.

Links

  • Level API Documentation - Official API documentation for the Level platform, useful for understanding available endpoints and parameters.

Discussion