Actions27
- Comments Actions
- List Groups Actions
- Static Images Actions
- Issues Actions
- Workflows Actions
- Attachments Actions
- Form Definitions Actions
- Import Actions
Overview
This node operation retrieves list groups associated with a specific iTwin project. It is useful when you want to fetch and filter groups within an iTwin environment, for example, to display or process group information related to an infrastructure digital twin.
Typical use cases include:
- Fetching all groups in an iTwin to manage permissions or memberships.
- Filtering groups by name to find specific teams or roles.
- Integrating group data into workflows that automate collaboration or reporting.
Properties
| Name | Meaning |
|---|---|
| iTwin ID | The unique identifier of the iTwin project for which to retrieve list groups. This is required. |
| Search | Optional string to filter list groups by their display name. Only groups whose names contain this string will be returned. |
Output
The node outputs an array of JSON objects representing the list groups retrieved from the iTwin API. Each object corresponds to a group and contains its details as provided by the API response.
No binary data output is indicated.
Dependencies
- Requires an API authentication token credential configured in n8n to access the Bentley iTwin platform API.
- The node uses the Bentley iTwin Issues API endpoint under the hood.
- Network connectivity to
https://api.bentley.comis necessary.
Troubleshooting
Common issues:
- Invalid or missing iTwin ID will cause the request to fail.
- Incorrect or expired API credentials will result in authentication errors.
- Network issues or API downtime can cause request failures.
Error messages:
"Unsupported operation": Indicates the node was called with an unsupported operation; ensure "Get iTwin list groups" is selected.- Authentication errors: Check that the API key or OAuth2 token is valid and properly configured.
- Request errors: Inspect the error message for HTTP status codes and adjust parameters accordingly.
Links and References
Note: The summary is based on static analysis of the bundled source code and provided property definitions without runtime execution.