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 iTwin members. The "Delete iTwin Member invitation" operation enables users to revoke or delete a pending invitation sent to a member for joining an iTwin project or resource. This is useful in scenarios where an invitation was sent by mistake, needs to be rescinded, or if the invitee should no longer have access.

Practical examples include:

  • Revoking an invitation that was sent to the wrong email address.
  • Canceling outstanding invitations before closing a project.
  • Managing user access lifecycle by cleaning up unused or expired invitations.

Properties

Name Meaning
ID The unique identifier of the iTwin project or resource from which the member invitation will be deleted.
Invitation ID The unique identifier of the specific member invitation to delete.

Output

The output is a JSON object representing the result of the deletion operation. Typically, this might be a confirmation of success or details about the deleted invitation. If the operation returns multiple results, each will be output as a separate JSON item.

No binary data output is indicated.

Dependencies

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

Troubleshooting

  • Common issues:

    • Invalid or missing ID or Invitation ID parameters will cause the operation to fail.
    • Authentication errors if the OAuth2 token is expired or misconfigured.
    • Network or API endpoint unavailability can cause request failures.

  • Error messages:

    • "Unknown operation: delete-itwin-member-invitation" indicates the operation name is incorrect or not supported.
    • Errors related to authentication typically suggest checking the API key or OAuth2 credentials.
    • If the invitation does not exist or has already been deleted, the API may return a not found error.

To resolve these:

  • Verify all required parameters are correctly set.
  • Ensure OAuth2 credentials are valid and refreshed.
  • Confirm the invitation ID exists and belongs to the specified iTwin resource.

Links and References

Discussion