iTwin Users & Access Control icon

iTwin Users & Access Control

Comprehensive iTwin Users and Access Control API

Actions37

Overview

This node interacts with the iTwin Users and Access Control API, specifically allowing management of members within an iTwin project. The "Remove iTwin owner member" operation removes a specified owner member from an iTwin instance. This is useful in scenarios where you need to revoke ownership access from a user, for example, when a team member leaves a project or changes roles.

Practical examples:

  • Removing a former project manager's ownership rights.
  • Cleaning up access control by removing outdated owner members.
  • Automating membership updates as part of a larger workflow managing iTwin project permissions.

Properties

Name Meaning
ID The unique identifier of the iTwin instance (project) from which the owner member will be removed.
Member ID The unique identifier of the member (user) who is to be removed as an owner from the specified iTwin.

Output

The output is a JSON object representing the result of the removal operation. It typically contains confirmation details or status information about the removal action. If multiple items are returned, each is output as a separate JSON object in the array.

No binary data output is indicated.

Example output structure might look like:

{
  "result": {
    "success": true,
    "message": "Owner member removed successfully"
  }
}

or simply the raw response from the API indicating success or failure.

Dependencies

  • Requires an API key credential for authenticating with the iTwin OAuth2 API.
  • The node depends on the iTwin Users & Access Control API being accessible.
  • Proper configuration of the OAuth2 credentials in n8n is necessary for successful execution.

Troubleshooting

  • Common issues:

    • Invalid or missing ID or Member ID parameters will cause the operation to fail.
    • Authentication errors if the OAuth2 token is expired or misconfigured.
    • Permission errors if the authenticated user does not have rights to remove owner members.

  • Error messages:

    • "Unknown operation: remove-itwin-owner-member": Indicates the operation name was not recognized; ensure the correct operation is selected.
    • API errors related to authorization or invalid IDs will be passed through; check that the provided IDs exist and the credentials have sufficient permissions.

  • Resolutions:

    • Verify input parameters are correctly set and valid.
    • Refresh or reconfigure the OAuth2 credentials.
    • Confirm the authenticated user has appropriate permissions in the iTwin project.

Links and References

Discussion