iTwin Users & Access Control

Overview

This node interacts with the iTwin platform to retrieve information about members who are owners of a specific iTwin. It is useful in scenarios where you need to programmatically access or manage ownership details of an iTwin project, such as auditing member roles, automating access control workflows, or integrating iTwin ownership data into other systems.

For example, you might use this node to fetch all owner members of an iTwin to verify permissions before performing further automated operations or to generate reports on project ownership.

Properties

Output

The node outputs JSON data representing the owner members of the specified iTwin. The structure typically includes details about each owner member, such as their user information and role within the iTwin. The output is an array of objects, each corresponding to one owner member.

If the operation returns multiple owner members, each will be included as a separate JSON object in the output array.

Dependencies

• Requires an API key credential for authenticating with the iTwin platform's OAuth2 service.
• The node depends on the iTwin Users & Access Control API.
• Proper configuration of the OAuth2 credentials in n8n is necessary to authorize requests.

Troubleshooting

• Common issues:

  • Invalid or missing iTwin ID: Ensure the "ID" property is correctly set and corresponds to an existing iTwin.
  • Authentication errors: Verify that the OAuth2 credentials are properly configured and have sufficient permissions.
  • Network or API errors: Check connectivity and API status.

• Error messages:

  • "Unknown operation: get-itwin-owner-members": This indicates the operation name was not recognized; ensure the operation parameter is correctly set.
  • Errors related to authentication or authorization usually indicate issues with the provided API credentials.
  • If the node fails but continueOnFail is enabled, error details will be included in the output JSON under an error field.

Links and References

• iTwin Developer Documentation
• Refer to the official iTwin Users & Access Control API documentation for detailed information on the data returned by the "Get iTwin owner members" operation.